MCP专家服务器
模型上下文协议服务器，使用Claude AI提供智能查询生成和文档帮助。该服务器分析API文档，并提供两个主要工具：
- 创建查询：根据自然语言请求生成查询
- 文档：根据问题提供相关文件信息
先决条件
- Node.js>=18
- Claude的人类学API密钥
安装
- 克隆存储库
- 安装依赖项：
npm install- 创建一个
.env使用您的Anthropic API密钥文件：
ANTHROPIC_API_KEY=your_api_key_here设置
在运行服务器之前，您需要：
- 构建项目并运行安装脚本：
npm run build
npm run setup这将：
- 创建所需的目录(
docs/和prompts/) - 创建默认提示文件
- 生成初始服务描述
- 将API文档文件添加到
docs/目录（支持.txt,.md，以及.json文件）
- （可选）自定义中的提示
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桌面集成
- 将此配置添加到您的Claude Desktop配置文件中：
{
"mcpServers": {
"expert": {
"command": "node",
"args": ["/ABSOLUTE/PATH/TO/expert-server/build/index.js"],
"env": {
"ANTHROPIC_API_KEY": "your_api_key_here"
}
}
}
}- 替换
/ABSOLUTE/PATH/TO/expert-server使用服务器安装的实际绝对路径。
- 重新启动克劳德桌面。
目录结构
.
├── 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
故障排除
如果您遇到连接问题：
- 确保您已运行安装脚本：
npm run setup- 检查所有必需的文件是否存在于
prompts/目录 - 验证您的
ANTHROPIC_API_KEY设置正确 - 在Claude Desktop配置中使用绝对路径
- 检查调试日志（写入stderr）
环境变量
ANTHROPIC_API_KEY：您的Anthropic API密钥（必需）
许可证
麻省理工学院