MCP Expert Server

🚀 MCP专家服务器

MCP专家服务器是一个基于模型上下文协议（Model Context Protocol）的服务器，借助Claude AI提供智能查询生成和文档辅助功能。它能对您的API文档进行分析，并提供两个实用工具：

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

🚀 快速开始

MCP专家服务器利用Claude AI，为您提供智能查询生成和文档辅助服务。您只需按照以下步骤操作，就能轻松使用。

✨ 主要特性

• 智能查询生成：通过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 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