openapi-mcp-swagger

概述

这个 MCP 服务器将复杂的 API 文档转换为智能的可搜索知识库，AI 助手可以直接查询。开发者不再需要为超出上下文窗口的 API 文档而烦恼，现在可以通过自然对话与他们的 API 交互。服务器索引 Swagger/OpenAPI 规范，并能快速响应关于端点、参数和模式的查询。它支持大型 API 文件（10MB+），并包含身份验证和监控等生产功能。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• searchEndpoints

  Search for API endpoints using natural language keywords

  试试:Find user management endpoints试试:Show me payment processing APIs试试:What endpoints handle authentication?
• getEndpointDetails

  Get detailed information about a specific API endpoint

  试试:Show me details for POST /users试试:Get parameters for the payment endpoint试试:What's the response schema for GET /products?
• generateCodeExample

  Generate code examples for using API endpoints

  试试:Generate Python code for user creation试试:Show me how to call the payment API in JavaScript试试:Give me a cURL example for the product endpoint
• listSchemas

  List all data schemas defined in the API specification

  试试:Show me all user-related schemas试试:List all payment schemas试试:What schemas are available for products?
• getSchemaDetails

  Get detailed information about a specific data schema

  试试:Show me the User schema details试试:What fields are in the Order schema?试试:Get details for the PaymentMethod schema

可对比工具

安装

# 从源码安装
git clone https://github.com/salacoste/openapi-mcp-swagger.git
cd openapi-mcp-swagger
pip install -r requirements.txt

# 将 Swagger 文件转换为 MCP 服务器
swagger-mcp-server convert swagger-openapi-data/your-api.json --name your-api

cd mcp-server-your-api
swagger-mcp-server serve

# 对于 Claude Desktop，添加到 Claude 的配置文件中：
{
  "mcpServers": {
    "your-api": {
      "command": "swagger-mcp-server",
      "args": ["serve", "--port", "8080"]
    }
  }
}```

FAQ

这个服务器能处理多大的 API 文档？

服务器可以处理高达 10MB+ 的 OpenAPI 文件，使用基于流的解析来高效处理大型规范。

哪些 AI 助手与此兼容？

适用于任何兼容 MCP 的工具，包括 Claude、Cursor、VS Code，以及通过标准 MCP 协议的自定义实现。

openapi-mcp-swagger 对比