🤖 Phrases MCP Server

✨ 核心功能

• 完整的短语管理：轻松创建、读取、更新和删除短语
• 与 Claude for Desktop 集成：直接从 Claude 与你的短语互动
• 内置 Mock API：用于测试和开发的 Mock API

🛠️ 工具列表

🚀 安装教程

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

# 安装依赖
npm install

# 编译项目
npm run build

🔌 配置与 Claude for Desktop 集成

1. 安装 Claude for Desktop（确保是最新版本）

2. 配置 Claude for Desktop 使用此 MCP 服务器：

打开配置文件（MAC/Linux）： ~/Library/Application Support/Claude/claude_desktop_config.json

1. 添加服务器配置：

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

1. 重启 Claude for Desktop

💡 使用示例

配置完成后，你可以直接从 Claude for Desktop 与短语互动：

• "显示所有可用的短语"
• "查找[作者名称]的短语"
• "为[名称]创建一个新短语，内容是[文本]"
• "将 ID 为[数字]的短语更新为[新文本]"
• "删除 ID 为[数字]的短语"

🧪 测试

测试前配置

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

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

注意：测试完成后请恢复原始配置以确保 MCP 服务器编译正常。

运行测试：

npm run test:requests

🔍 MockAPI 配置

项目使用 MockAPI 作为后端存储短语。基础 URL 配置为：

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

配置你自己的 MockAPI 实例

1. 在 MockAPI 创建账户
2. 创建新项目
3. 创建名为 user 的资源，包含以下字段：
4. id (number, 自动生成)
5. name (string)
6. phrase (string)
7. 复制你的 API URL
8. 更新 src/helpers/makeMockAPIRequest.ts 文件中的 BASE_URL 常量

// 替换为你的 MockAPI URL
const BASE_URL = "https://tu-proyecto.mockapi.io/tu-path/user";

📝 注意事项

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

许可证

该项目遵循 ISC 开源许可条款。