✨ 核心功能
- 完整的短语管理：轻松创建、读取、更新和删除短语
- 与 Claude for Desktop 集成：直接从 Claude 与你的短语互动
- 内置 Mock API：用于测试和开发的 Mock API
🛠️ 工具列表
| 工具 | 描述 |
|-------------|-------------|
| get-all-phrases | 获取所有可用的短语 |
| get-phrase-by-id | 通过 ID 查找短语 |
| get-phrase-by-name | 通过作者名称查找短语 |
| create-phrase | 创建新短语 |
| update-phrase | 更新现有短语的文本 |
| delete-phrase | 通过 ID 删除短语 |
🚀 安装教程
```bash
克隆仓库
git clone https://github.com/ronniemh/phrases-MCP-server.git
cd phrases-MCP-server
安装依赖
npm install
编译项目
npm run build
```
🔌 配置与 Claude for Desktop 集成
-
安装 Claude for Desktop（确保是最新版本）
-
配置 Claude for Desktop 使用此 MCP 服务器：
打开配置文件（MAC/Linux）：
~/Library/Application Support/Claude/claude_desktop_config.json
- 添加服务器配置：
json
{
"mcpServers": {
"phrases": {
"command": "node",
"args": [
"/RUTA_ABSOLUTA_A/phrases/build/index.js"
]
}
}
}
- 重启 Claude for Desktop
💡 使用示例
配置完成后，你可以直接从 Claude for Desktop 与短语互动：
- "显示所有可用的短语"
- "查找[作者名称]的短语"
- "为[名称]创建一个新短语，内容是[文本]"
- "将 ID 为[数字]的短语更新为[新文本]"
- "删除 ID 为[数字]的短语"
🧪 测试
测试前配置
在运行测试前，需要临时修改 tsconfig.json 文件。将 compilerOptions 部分改为：
json
"compilerOptions": {
"target": "ES2020",
"module": "NodeNext",
"moduleResolution": "NodeNext",
"esModuleInterop": true,
"outDir": "build",
"strict": true
}
注意：测试完成后请恢复原始配置以确保 MCP 服务器编译正常。
运行测试：
bash
npm run test:requests
🔍 MockAPI 配置
项目使用 MockAPI 作为后端存储短语。基础 URL 配置为：
https://67ec86aeaa794fb3222e0682.mockapi.io/frases/api/v1/user
配置你自己的 MockAPI 实例
- 在 MockAPI 创建账户
- 创建新项目
- 创建名为
user的资源，包含以下字段： id(number, 自动生成)name(string)phrase(string)- 复制你的 API URL
- 更新
src/helpers/makeMockAPIRequest.ts文件中的BASE_URL常量
typescript
// 替换为你的 MockAPI URL
const BASE_URL = "https://tu-proyecto.mockapi.io/tu-path/user";
📝 注意事项
- 此服务器使用 Mock API 存储数据。在生产环境中，建议实现真实数据库。
- 项目结构遵循 MCP 官方指南 以保持可维护性。
- 如果遇到 Mock API 问题，请检查 MockAPI 的免费使用限制。
