🤖 短语 MCP 服务器

一个优雅高效的 MCP（模型上下文协议）服务器，用于管理励志名言。旨在与 Claude for Desktop 和其他 MCP 客户端无缝集成。

✨ 特点

• 完整的短语管理——轻松创建、阅读、更新和删除短语

• Claude 桌面集成- 直接通过 Claude 与您的短语进行交互

• 集成 Mock API - 使用模拟 API 进行测试和开发

🛠️ 可用工具

该服务器公开以下 MCP 工具：

🚀 安装

🔌 使用 Claude 桌面版进行设置

1. 安装Claude 桌面版（确保您拥有最新版本）

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

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

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

3. 添加服务器配置：

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

4. 重启 Claude 桌面版

💡 与 Claude 一起使用

配置完成后，您可以直接从 Claude for Desktop 与短语进行交互：

• “显示所有可用的短语”

• “查找 [作者姓名] 的引文”

• “为 [name] 创建一个新句子，内容为 [text]”

• “将 ID 为 [number] 的短语更新为 [new text]”

• “删除 ID 为 [number] 的短语”

🧪 测试

⚠️ 重要：测试设置

在运行测试之前，您应该临时修改tsconfig.json文件。将compilerOptions部分更改为：

注意：测试后请不要忘记恢复到原始配置，以确保 MCP 服务器构建正常工作。

运行测试：

此命令将运行一系列使用模拟 API 创建、读取、更新和删除句子的测试。

🏗️ 项目结构

🔄 开发工作流程

1. 修改src/中的代码

2. 使用npm run build进行编译

3. 使用npm run test:requests进行测试

4. 重新启动 Claude for Desktop 以应用更改

🔍 MockAPI 配置

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

设置您自己的 MockAPI 实例

1. 在MockAPI上创建一个帐户

2. 创建新项目

3. 创建一个名为user资源，其中包含以下字段：

   • id （数字，自动生成）

   • name （字符串）

   • phrase （字符串）

4. 复制您的 API URL

5. 更新src/helpers/makeMockAPIRequest.ts文件中的BASE_URL常量

📝 附加说明

• 该服务器使用模拟 API 来存储数据。在生产环境中，考虑实现一个真实的数据库。

• 项目结构遵循官方 MCP 指南，以提高可维护性。

• 如果您遇到 Mock API 问题，请检查 MockAPI 免费使用限制。

📄 许可证

国际学习中心