MCP 服务器

OpenAPI MCP Server

一个模型上下文协议服务器，它使大型语言模型（LLM）能够通过自然语言提示与 REST API 进行交互并执行 REST API 调用，支持对已配置 API 的 GET/PUT/POST/PATCH 操作。

README

OpenAPI MCP 服务器

概述

此项目将安装 MCP - 模型上下文协议服务器，该服务器提供配置的 REST API 作为 LLM 的上下文。
使用此功能，我们可以使 LLM 与 RestAPI 交互，并使用 LLM 提示执行 REST API 调用。
目前我们支持 HTTP API 调用 GET/PUT/POST/PATCH。

安装

安装包
```
pip install openapi_mcp_server
```
在文件夹中创建一个 .env 文件，其中包含 OPENAPI_SPEC_PATH 和 API_BASE_URL 的最小值。示例文件可在此处获取：here
使用 uv run openapi_mcp_server 从上述文件夹测试 openapi_mcp_server 服务器。

Claud Desktop

Claud Desktop 的配置详情

{
  "mcpServers": {
    "openapi_mcp_server":{
      "command": "uv",
      "args": ["run","openapi_mcp_server"]
      "env": {
          "DEBUG":"1",
          "API_BASE_URL":"https://petstore.swagger.io/v2",
          "OPENAPI_SPEC_PATH":"https://petstore.swagger.io/v2/swagger.json",
          "API_HEADERS":"Accept:application/json",
          "API_WHITE_LIST":"addPet,updatePet,findPetsByStatus"
      }
    }
  }
}

配置

可用的环境变量列表
- DEBUG: 启用调试日志记录（可选，默认为 False）
- OPENAPI_SPEC_PATH: OpenAPI 文档的路径。（必需）
- API_BASE_URL: API 请求的基本 URL。（必需）
- API_HEADERS: 要包含在 API 请求中的标头（可选）
- API_WHITE_LIST: 白名单 operationId，格式为列表 ["operationId1", "operationId2"]（可选）
- API_BLACK_LIST: 黑名单 operationId，格式为列表 ["operationId3", "operationId4"]（可选）
- HTTP_PROXY: HTTP 代理详情（可选）
- HTTPS_PROXY: HTTPS 代理详情（可选）
- NO_PROXY: 无代理详情（可选）

贡献

欢迎贡献。请随时提交 Pull Request。

许可证

本项目根据 MIT 许可证的条款获得许可。

Github Stars

附录

UV

mkdir -m777 openapi_mcp_server
cd openapi_mcp_server
uv init
uv add mcp[cli] pydantic python-dotenv requests
uv add --dev twine setuptools
uv sync
uv run openapi_mcp_server
uv build
pip install --force-reinstall --no-deps .\dist\openapi_mcp_server-*fileversion*.whl
export TWINE_USERNAME="rahgadda"
export TWINE_USERNAME="<<API Key>>"
uv run twine upload --verbose dist/*