AI导哈

智能查询生成与文档辅助服务

一个基于Claude AI的模型上下文协议服务器，提供智能查询生成和文档辅助功能，帮助用户通过自然语言请求生成查询并获取相关文档信息。

  • by crazyrabbitLTC
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 crazyrabbitltc/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 文件）

  2. （可选）自定义中的提示 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 使用服务器安装的实际绝对路径。

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

目录结构

.
├── 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密钥（必需）

许可证

麻省理工学院

相关 MCP