🤖 Phrases MCP 服务器

一个优雅且高效的 MCP (模型上下文协议) 服务器，用于管理鼓舞人心的短语。 旨在与 Claude for Desktop 和其他 MCP 客户端无缝集成。

<div align="center"> <img src="https://github.com/ronniemh/phrases-MCP-server/raw/main/assets/diagram.png" alt="架构图" width="600"> </div>

✨ 特性

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

🛠️ 可用工具

服务器公开以下 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 for Desktop 配置

1. 安装 Claude for Desktop (确保你拥有最新版本)

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

   打开配置文件 (MAC/Linux) 在：

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

3. 添加服务器配置：

   {
       "mcpServers": {
           "phrases": {
               "command": "node",
               "args": [
                   "/绝对路径/phrases/build/index.js"
               ]
           }
       }
   }
   

4. 重启 Claude for Desktop

💡 与 Claude 一起使用

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

• "Muéstrame todas las frases disponibles" (显示所有可用的短语)
• "Busca frases de [nombre de autor]" (查找 [作者姓名] 的短语)
• "Crea una nueva frase para [nombre] que diga [texto]" (为 [姓名] 创建一个新短语，内容为 [文本])
• "Actualiza la frase con ID [número] a [nuevo texto]" (将 ID 为 [数字] 的短语更新为 [新文本])
• "Elimina la frase con ID [número]" (删除 ID 为 [数字] 的短语)

🧪 测试

⚠️ 重要提示：测试配置

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

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

注意: 测试后不要忘记恢复到原始配置，以便 MCP 服务器的编译正常工作。

要运行测试：

npm run test:requests

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

🏗️ 项目结构

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

🔄 开发工作流程

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

🔍 MockAPI 配置

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

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

配置你自己的 MockAPI 实例

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

// 使用你自己的 MockAPI URL 更改此行
const BASE_URL = "https://tu-proyecto.mockapi.io/tu-path/user";

📝 附加说明

• 此服务器使用 API mock 来存储数据。 在生产环境中，请考虑实现一个真正的数据库。
• 项目结构遵循 MCP 官方指南，以获得更好的可维护性。
• 如果你发现 API mock 有问题，请检查 MockAPI 的免费使用限制。

📄 许可证

ISC