API 文档 MCP 服务器

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

功能

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

安装

# Create and activate a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install the package
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