🤖 Phrases MCP Server

🤖 Phrases MCP Server

一款优雅高效的 MCP（Model Context Protocol）服务，用于管理励志短句。专为与 Claude for Desktop 和其他 MCP 客户端无缝集成而设计。

✨ 特性

• 全面的短句管理 - 轻松创建、读取、更新和删除短句
• 与 Claude for Desktop 集成 - 直接在 Claude 中管理短句
• 内置 Mock API - 使用 Mock API 进行测试和开发

🛠️ 可用工具

no 服务提供以下 MCP 工具：

工具	描述
get-all-phrases	获取所有可用短句
get-phrase-by-id	按 ID 搜索短句
get-phrase-by-name	按作者姓名搜索短句
create-phrase	创建新短句
update-phrase	更新现有短句的文本
delete-phrase	按 ID 删除短句

🚀 安装

# Clonar el repositorio
git clone https://github.com/ronniemh/phrases-MCP-server.git
cd phrases-MCP-server

# Instalar dependencias
npm install

# Compilar el proyecto
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": [
                   "/RUTA_ABSOLUTA_A/phrases/build/index.js"
               ]
           }
       }
   }
   

4. 重启 Claude for Desktop

💡 在 Claude 中使用

配置完成后，你可以直接在 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

此命令将使用 Mock API 执行一系列测试，创建、读取、更新和删除短句。

🏗️ 项目结构

src/
├── helpers/
│   └── makeMockAPIRequest.ts  # Funciones de ayuda para interactuar con la API
├── index.ts                   # Punto de entrada principal y definición de herramientas
└── testRequest.ts             # Script para probar las funciones de la 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 常量

// Cambia esta línea con tu propia URL de MockAPI
const BASE_URL = "https://tu-proyecto.mockapi.io/tu-path/user";

📝 补充说明

• 此服务使用 Mock API 存储数据。在生产环境中，建议使用真实数据库。
• 项目结构遵循 MCP 官方指南，以便更好地维护。
• 如果 Mock API 出现问题，请检查 MockAPI 的免费使用额度限制。

📄 许可证

ISC