Phrases

🚀 🤖 短语 MCP 服务器

这是一个优雅且高效的短语 MCP 服务器，主要用于管理励志短语。它专为与桌面版 Claude 以及其他 MCP 客户端实现无缝集成而精心设计，能为用户提供便捷的短语管理体验。

🚀 快速开始

本服务器可轻松实现短语管理，还能与桌面版 Claude 集成。以下是快速启动服务器的步骤：

1. 克隆仓库：

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

2. 安装依赖项：

npm install

3. 启动服务器：

node index.js

✨ 主要特性

• 完整的短语管理：可轻松创建、读取、更新和删除短语。
• 与桌面版 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

测试说明

注意事项：

在测试前，请先修改 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 值。

💻 使用示例

基础用法

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

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

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

🔧 技术细节

本项目的技术实现涵盖了短语管理服务器的搭建、与桌面版 Claude 的集成以及 mock API 的使用。通过克隆仓库、安装依赖和启动服务器，可快速搭建开发环境。同时，项目结构清晰，便于开发和维护。

📄 许可证

本项目采用 ISC 许可证。

⚠️ 重要提示

本服务器使用 mock API 存储数据。在生产环境中，请考虑集成真实数据库。

💡 使用建议

如遇 MockAPI 相关问题，请检查免费层的使用限制。项目结构遵循官方 MCP 指南，有助于更好地进行维护。