MCP Expert Server

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

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

前提条件

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

安装

1. 克隆存储库
2. 安装依赖项：

npm install

3. 创建一个包含您的 Anthropic API 密钥的 .env 文件：

ANTHROPIC_API_KEY=your_api_key_here

设置

在运行服务器之前，您需要：

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

npm run build
npm run setup

这将：

• 创建所需的目录 (docs/ 和 prompts/)
• 创建默认的 prompt 文件
• 生成初始服务描述

2. 将您的 API 文档文件添加到 docs/ 目录（支持 .txt、.md 和 .json 文件）

3. （可选）自定义 prompts/ 目录中的 prompt：

   • system-prompt.txt: Claude 的主要系统 prompt
   • tool-metadata.txt: 工具描述的附加上下文
   • query-metadata.txt: 查询生成的附加上下文
   • service-description.txt: 自动生成的服务描述

用法

独立服务器

启动服务器：

npm start

该服务器通过模型上下文协议公开两个工具：

• create-query: 基于自然语言请求生成查询

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

• documentation: 从文档中获取信息

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

Claude Desktop 集成

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/              # 系统 prompt 和元数据
│   ├── system-prompt.txt    # 主要系统 prompt
│   ├── 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 类处理
• 调试日志以 [DEBUG] 前缀写入 stderr

故障排除

如果您遇到连接问题：

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

npm run setup

2. 检查 prompts/ 目录中是否存在所有必需的文件
3. 验证您的 ANTHROPIC_API_KEY 是否已正确设置
4. 在您的 Claude Desktop 配置中使用绝对路径
5. 检查调试日志（写入 stderr）

环境变量

• ANTHROPIC_API_KEY: 您的 Anthropic API 密钥（必需）

许可证

MIT