🤖 Phrases MCP 服务器

一个优雅且高效的MCP（模型上下文协议）服务器，用于管理励志短语。设计上旨在与桌面版Claude和其他MCP客户端完美集成。

<div align="center"> <img src="https://gips1.baidu.com/it/u=739116045,1436427091&fm=3081&app=3081&f=PNG?w=1112&h=306" alt="架构图" width="600"> </div>

✨ 特性

• 全面的短语管理 - 轻松创建、读取、更新和删除短语
• 与桌面版Claude集成 - 直接从Claude与你的短语互动
• 内置模拟API - 使用模拟API进行测试和开发

🛠️ 可用工具

无 该服务器提供了以下MCP工具：

工具	描述
get-all-phrases	获取所有可用短语
get-phrase-by-id	根据ID查找短语
get-phrase-by-name	根据作者名查找短语
create-phrase	创建新的短语
update-phrase	更新现有短语的文本
delete-phrase	根据ID删除短语

🚀 安装

# 克隆仓库
git clone https://github.com/ronniemh/phrases-MCP-server.git
cd phrases-MCP-server

# 安装依赖
npm install

# 编译项目
npm run build

🔌 配置桌面版Claude

1. 安装 桌面版Claude（确保是最新版本）

2. 配置桌面版Claude以使用此MCP服务器：

   打开配置文件（MAC/Linux）：

   ~/Library/Application Support/Claude/claude_desktop_config.json
   

3. 添加服务器配置：

   {
       "mcpServers": {
           "phrases": {
               "command": "node",
               "args": [
                   "/ABSOLUTE_PATH_TO/phrases/build/index.js"
               ]
           }
       }
   }
   

4. 重启桌面版Claude

💡 使用桌面版Claude

配置完成后，你可以直接从桌面版Claude与你的短语互动：

• "显示所有可用短语"
• "查找[作者名]的短语"
• "为[名字]创建一条新短语，内容为[文本]"
• "将ID为[número]的短语更新为[new text]"
• "删除ID为[número]的短语"

🧪 测试

⚠️ 重要：测试配置

在运行测试之前，你需要临时修改tsconfig.json文件。将compilerOptions部分改为：

"compilerOptions": {
  "target": "ES2020",
  "module": "NodeNext",
  "moduleResolution": "NodeNext",
  "esModuleInterop": true,
  "outDir": "build",
  "strict": true
}

注意：别忘了在测试后恢复原始配置，以便MCP服务器的编译能正常工作。

要执行测试：

npm run test:requests

此命令将运行一系列测试，这些测试使用模拟API创建、读取、更新和删除短语。

🏗️ 项目结构

src/
├── helpers/
│   └── makeMockAPIRequest.ts  # 与API交互的帮助函数
├── index.ts                   # 主入口点和工具定义
└── testRequest.ts             # 测试API功能的脚本

🔄 开发流程

1. 修改src/中的代码
2. 使用npm run build编译
3. 使用npm run test:requests测试
4. 重启桌面版Claude以应用更改

🔍 MockAPI配置

该项目使用MockAPI作为后端来存储和管理短语。已配置的基础URL为：

https://67ec86aeaa794fb3222e0682.mockapi.io/frases/api/v1/user

配置你自己的MockAPI实例

1. 在MockAPI注册账户
2. 创建一个新的项目
3. 创建一个名为user的资源，包含以下字段：
   • id（数字，自动生成）
   • name（字符串）
   • phrase（字符串）
4. 复制你的API URL
5. 更新src/helpers/makeMockAPIRequest.ts文件中的BASE_URL常量

// 使用你自己的MockAPI URL替换此行
const BASE_URL = "https://your-project.mockapi.io/your-path/user";

📝 其他注意事项

• 此服务器使用模拟API存储数据。在生产环境中，请考虑实现真实的数据库。
• 项目的结构遵循MCP官方指南，以提高可维护性。
• 如果你在使用模拟API时遇到问题，请检查MockAPI的免费使用限制。

📄 许可证

ISC