Crazyrabbitltc MCP Expert Server

🚀 MCP专家服务器

MCP专家服务器是一个基于模型上下文协议（Model Context Protocol）的服务器，借助Claude AI实现智能查询生成与文档辅助功能。它会分析您的API文档，并提供两个实用工具：

• create-query：依据自然语言请求生成查询。
• documentation：根据问题提供相关文档信息。

🚀 快速开始

先决条件

• Node.js >= 18
• 拥有用于Claude的Anthropic API密钥。

📦 安装指南

1. 克隆仓库。
2. 安装依赖：

npm install

3. 创建一个.env文件，将您的Anthropic API密钥填入其中：

ANTHROPIC_API_KEY=your_api_key_here

🔧 设置

在启动服务器之前，请完成以下操作：

1. 构建项目并运行设置脚本：

npm run build
npm run setup

此操作将完成以下任务：

• 创建所需的目录（docs/ 和 prompts/）。
• 创建默认提示文件。
• 生成初始服务描述。

2. 把您的API文档文件添加到docs/目录中（支持.txt、.md和.json文件）。
3. 可在prompts/目录中进行自定义提示：
   • system-prompt.txt：Claude的主要系统提示。
   • tool-metadata.txt：工具描述的额外上下文。
   • query-metadata.txt：查询生成的额外上下文。
   • service-description.txt：自动生成的服务描述。

💻 使用示例

基础用法

独立服务器

启动服务器：

npm start

该服务器通过模型上下文协议（MCP）提供两个工具：

• create-query：根据自然语言请求生成查询

{
    "name": "create-query",
    "arguments": {
        "request": "查找过去一周内注册的所有用户"
    }
}

• documentation：从文档中获取信息

{
    "name": "documentation",
    "arguments": {
        "request": "如何进行API请求认证？"
    }
}

Claude桌面集成

1. 将以下配置添加到您的Claude桌面配置文件中：

{
    "mcpServers": {
        "expert": {
            "command": "node",
            "args": ["/ABSOLUTE/PATH/TO/expert-server/build/index.js"],
            "env": {
                "ANTHROPIC_API_KEY": "your_api_key_here"
            }
        }
    }
}

2. 将/ABSOLUTE/PATH/TO/expert-server替换为服务器安装的实际绝对路径。
3. 重启Claude桌面。

📚 详细文档

目录结构

.
├── docs/                  # 您的API文档文件
├── prompts/              # 系统提示和元数据
│   ├── system-prompt.txt    # 主要系统提示
│   ├── tool-metadata.txt    # 工具描述的额外上下文
│   ├── query-metadata.txt   # 查询生成的额外上下文
│   └── service-description.txt  # 生成的服务描述
├── src/                  # 源代码
│   ├── index.ts            # 入口点
│   ├── server.ts           # MCP服务器实现
│   └── services/           # 核心服务
│       └── expertService.ts  # Claude集成
└── package.json

开发

• 构建项目：

npm run build

• 该服务器使用TypeScript，并遵循模块化架构。
• 所有Claude交互均由ExpertService类处理。
• 调试日志记录到stderr，带有[DEBUG]前缀。

故障排除

如果您遇到连接问题，请按以下步骤操作：

1. 确保已运行设置脚本：

npm run setup

2. 检查prompts/目录下所有必需文件是否存在。
3. 验证您的ANTHROPIC_API_KEY是否正确设置。
4. 在Claude桌面配置中使用绝对路径。
5. 查看调试日志以获取更多信息。

环境变量

• ANTHROPIC_API_KEY：Anthropic API的密钥，用于访问Claude模型。

📄 许可证

此项目受MIT License保护。