🤖 短语 MCP 服务器

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

✨ 特点

完整的短语管理——轻松创建、阅读、更新和删除短语
Claude 桌面集成- 直接通过 Claude 与您的短语进行交互
集成 Mock API - 使用模拟 API 进行测试和开发

🛠️ 可用工具

该服务器公开以下 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 桌面版进行设置

安装Claude 桌面版（确保您拥有最新版本）
配置 Claude for Desktop 以使用此 MCP 服务器：打开配置文件（MAC/Linux）：
~/Library/Application Support/Claude/claude_desktop_config.json
添加服务器配置：
{ "mcpServers": { "phrases": { "command": "node", "args": [ "/RUTA_ABSOLUTA_A/phrases/build/index.js" ] } } }
重启 Claude 桌面版

💡 与 Claude 一起使用

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

“显示所有可用的短语”
“查找 [作者姓名] 的引文”
“为 [name] 创建一个新句子，内容为 [text]”
“将 ID 为 [number] 的短语更新为 [new text]”
“删除 ID 为 [number] 的短语”

🧪 测试

⚠️ 重要：测试设置

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

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

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

运行测试：

npm run test:requests

此命令将运行一系列使用模拟 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

🔄 开发工作流程

修改src/中的代码
使用npm run build进行编译
使用npm run test:requests进行测试
重新启动 Claude for Desktop 以应用更改

🔍 MockAPI 配置

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

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

设置您自己的 MockAPI 实例

在MockAPI上创建一个帐户
创建新项目
创建一个名为user资源，其中包含以下字段：
- id （数字，自动生成）
- name （字符串）
- phrase （字符串）
复制您的 API URL
更新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";

📝 附加说明

该服务器使用模拟 API 来存储数据。在生产环境中，考虑实现一个真实的数据库。
项目结构遵循官方 MCP 指南，以提高可维护性。
如果您遇到 Mock API 问题，请检查 MockAPI 免费使用限制。

📄 许可证

国际学习中心

Phrases MCP Server