OpenAPI MCP Server

概述

• 该项目将安装 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。示例文件可在此处找到 这里
• 使用 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: 白名单操作ID列表格式 ["operationId1", "operationId2"]（可选）
  • API_BLACK_LIST: 黑名单操作ID列表格式 ["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/*

参考

• UV 概览