MCP Expert Server

MCP专家服务器

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

• 创建查询：根据自然语言请求生成查询
• 文档：根据问题提供相关文件信息

先决条件

• Node.js>=18
• Claude的人类学API密钥

安装

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

npm install

1. 创建一个 .env 使用您的Anthropic API密钥文件：

ANTHROPIC_API_KEY=your_api_key_here

设置

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

1. 构建项目并运行安装脚本：

npm run build
npm run setup

这将：

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

1. 将API文档文件添加到 docs/ 目录（支持 .txt, .md，以及 .json 文件）

1. （可选）自定义中的提示 prompts/ 目录：

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

用法

独立服务器

启动服务器：

npm start

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

• 创建查询：根据自然语言请求生成查询

  {
    "name": "create-query",
    "arguments": {
      "request": "Find all users who signed up in the last week"
    }
  }

• 文档：从文档中获取信息

  {
    "name": "documentation",
    "arguments": {
      "request": "How do I authenticate API requests?"
    }
  }

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"
      }
    }
  }
}

1. 替换 /ABSOLUTE/PATH/TO/expert-server 使用服务器安装的实际绝对路径。

1. 重新启动克劳德桌面。

目录结构

.
├── docs/                  # Your API documentation files
├── prompts/              # System prompts and metadata
│   ├── system-prompt.txt    # Main system prompt
│   ├── tool-metadata.txt    # Tool description context
│   ├── query-metadata.txt   # Query generation context
│   └── service-description.txt  # Generated service description
├── src/                  # Source code
│   ├── index.ts            # Entry point
│   ├── server.ts           # MCP server implementation
│   └── services/           # Core services
│       └── expertService.ts  # Claude integration
└── package.json

发展

• 构建项目：

npm run build

• 服务器使用TypeScript并遵循模块化架构
• 所有Claude交互都由ExpertService类处理
• 调试日志以\[Debug\]前缀写入stderr

故障排除

如果您遇到连接问题：

1. 确保您已运行安装脚本：

npm run setup

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

环境变量

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

许可证

麻省理工学院