🚀 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桌面。

🔧 技术细节

开发相关

• 构建项目：

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保护。