MCP专家服务器

一个模型上下文协议（Model Context Protocol）服务器，利用Claude AI提供智能查询生成和文档辅助功能。该服务器分析您的API文档并提供两个主要工具：

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

先决条件

• Node.js >= 18
• Anthropic API密钥用于Claude

安装

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 Desktop配置文件中：

{
  "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 Desktop。

目录结构

.
├── docs/                  # 您的API文档文件
├── prompts/              # 系统提示和元数据
│   ├── system-prompt.txt    # 主系统提示
│   ├── tool-metadata.txt   # 工具描述的元数据
│   ├── query-metadata.txt  # 查询生成的元数据
│   └── service-description.txt # 自动生成的服务描述
├── build/                # 构建输出目录（由脚本创建）
└── package.json          # 项目依赖和脚本配置

开发

• 使用命令npm run dev启动开发服务器。
• 所有代码都在src/目录下，遵循模块化结构。

故障排除

1. 确保Node.js版本 >= 18。
2. 检查.env文件中的API密钥是否正确设置。
3. 在运行脚本前安装所有依赖：npm install

环境变量

• ANTHROPIC_API_KEY：Anthropic API的访问密钥。

许可证

MIT License

此翻译保持了原文的技术细节和结构，同时使用中文进行自然表达，确保用户能够清晰理解和操作。