API 文档 MCP 服务器

一个用于抓取 API 文档网站并通过模型上下文协议 (Model Context Protocol, MCP) 暴露其内容的 MCP 服务器。这使得 AI 模型能够搜索、浏览和引用 API 规范。

功能

• 抓取 API 文档网站以提取结构化信息
• 通过 MCP 将 API 文档作为资源暴露
• 提供用于查找特定 API 端点的搜索工具
• 包含用于常见 API 文档任务的提示模板
• 存储抓取的数据以供离线访问

安装

# 创建并激活虚拟环境
python -m venv venv
source venv/bin/activate  # 在 Windows 上：venv\Scripts\activate

# 安装包
pip install -e .

使用

启动服务器

python -m src.main --url https://example-api-docs.com

连接到服务器

此 MCP 服务器可以连接到任何 MCP 客户端，例如 Claude for Desktop。配置您的客户端以使用此服务器，配置如下：

{
  "api-docs": {
    "command": "python",
    "args": ["-m", "src.main", "--url", "https://example-api-docs.com"]
  }
}

MCP 功能

资源

• API 端点规范
• 数据模型和模式
• API 示例和代码片段

工具

• search_api: 按名称、路径或描述搜索 API 端点
• get_endpoint_details: 获取有关特定端点的详细信息
• list_endpoints: 列出所有可用的 API 端点
• find_examples: 查找特定 API 端点的示例

提示

• explain_endpoint: 生成 API 端点的自然语言解释
• compare_endpoints: 比较两个 API 端点
• generate_code: 生成使用 API 端点的示例代码

许可

MIT