🤖 短语 MCP 服务器

一个优雅且高效的短语 MCP 服务器，用于管理励志短语。专为与桌面版 Claude 和其他 MCP 客户端无缝集成而设计。

✨ 特性

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

🛠️ 可用工具

技术细节

安装步骤

1. 克隆仓库：

git clone https://github.com/ronniemh/phrases-MCP-server.git

2. 安装依赖项：

npm install

3. 启动服务器：

node index.js

🛠️ 与桌面版 Claude 的配置

步骤说明：

1. 复制配置文件：将 config.json 复制到项目根目录。
2. 编辑配置文件：根据需要修改 API 地址和其他参数。
3. 重启服务器：完成配置后重启 MCP 服务。

示例路径：

Windows：%UserProfile%\.claude\config.json
MacOS 和 Linux：~/.claude/config.json

📝 使用示例

在桌面版 Claude 中，您可以执行以下命令与短语管理器交互：

• 创建新短语：

POST /api/v1/phrases HTTP/1.1
Content-Type: application/json

{
  "phrase": "你的励志短语"
}

📋 测试说明

注意事项：

在测试前，请先修改 tsconfig.json 文件中的以下内容：

// 修改此部分以适应测试环境
const BASE_URL = "https://mockapi.io/your-project/user";

📁 项目结构

• src/：包含所有源代码文件。
• public/：存放公共资产，如图片和样式表。
• config.json：项目的配置文件。

📋 开发流程

工作流说明：

1. 编码阶段：

   • 编写核心功能
   • 实现与桌面版 Claude 的交互逻辑

2. 测试阶段：

   • 执行单元测试
   • 确保 API 请求正确无误

3. 部署阶段：

   • 提交代码到仓库
   • 推送到生产环境

🛠️ MockAPI 配置

创建自己的实例：

1. 注册 MockAPI 账户。

2. 创建新项目并添加 user 资源，包含以下字段：

   • id（数字，自动生成）
   • name（字符串）
   • phrase（字符串）

3. 获取并替换 src/helpers/makeMockAPIRequest.ts 中的 BASE_URL 值。

📝 注意事项

• 本服务器使用 mock API 存储数据。在生产环境中，请考虑集成真实数据库。
• 项目结构遵循官方 MCP 指南，以确保更好的维护性。
• 如遇 MockAPI 相关问题，请检查免费层的使用限制。

📄 许可证

ISC