Openapi2mcpserver

🚀 OpenAPI 轉 MCP 服務器

本項目可直接根據提供的 openapi.yaml 文件啟動一個模型上下文協議（MCP）服務器，使用 uv 進行依賴管理。每個 HTTP 端點都會成為一個 MCP 工具，供 AnythingLLM（或任何支持 MCP 的客戶端）調用。

🚀 快速開始

1. 安裝依賴

uv sync

2. 配置 openapi2mcpserver/config.yaml

base_url: "https://localhost:12001"
verify_ssl: false
openapi_path: "../openapi.yaml"           # 可選，默認為倉庫根目錄下的副本
log_file: "../logs/openapi2mcpserver.log" # 可選，啟用文件日誌記錄
log_level: "INFO"                         # 可選，支持 DEBUG/INFO/WARNING/ERROR

auth:
  mode: "basic"                           # 選項：none/basic/bearer/header/query
  username: "your-username"
  password: "your-password"
  # basic_token: "cHJlLWVuY29kZWQtY3JlZHM="
  # extra_headers:
  #   X-API-Version: "1"

# default_headers:
#   X-Request-Source: "mcp"

3. 啟動 MCP 服務器

uv run openapi2mcpserver

💻 使用示例

在 AnythingLLM 中使用此 MCP 服務器

以下步驟針對 AnythingLLM 桌面插件系統，列出了 macOS 和 Windows 的默認路徑。如果文件不存在，請創建該文件，並將示例路徑替換為你機器上的實際值。

macOS

1. 打開 ~/Library/Application Support/anythingllm-desktop/storage/plugins/anythingllm_mcp_servers.json
2. 添加或合併以下配置：

{
  "mcpServers": {
    "rhino-agent": {
      "command": "/Users/<你的用戶名>/.local/bin/uv",
      "args": ["run", "--project", "/Users/<你的用戶名>/workspace/AIProjects/openapi2mcpserver", "openapi2mcpserver"]
    }
  }
}

Windows

1. 打開 %APPDATA%\anythingllm-desktop\storage\plugins\anythingllm_mcp_servers.json
2. 如果你使用 uv.exe，將路徑替換為 where uv 的輸出，例如：

{
  "mcpServers": {
    "rhino-agent": {
      "command": "C:\\Users\\<YourUser>\\AppData\\Roaming\\Python\\Scripts\\uv.exe",
      "args": ["run", "--project", "C:\\Users\\<YourUser>\\workspace\\AIProjects\\openapi2mcpserver", "openapi2mcpserver"]
    }
  }
}

保存後重新啟動 AnythingLLM（或在設置中重新加載插件），你應該會在工作區的工具列表中看到 rhino-agent。

✨ 主要特性

• 自動解析每個 OpenAPI 路徑並註冊匹配的 MCP 工具
• 提供 OpenAPI_GetSchema 以檢查 components.schemas
• 工具輸入涵蓋路徑參數、查詢參數、請求頭和請求體
• 靈活的身份驗證（無/基本/承載/自定義請求頭/查詢參數）以及全局默認請求頭
• 同時在控制檯和文件中進行結構化日誌記錄，便於 LLM 故障排除

📚 詳細文檔

項目結構

openapi2mcpserver/
    __init__.py
    __main__.py
    client.py
    config.py
    openapi_loader.py
    server.py

運行時注意事項

服務器啟動時會讀取 OpenAPI 描述，為每個工具構建 JSON Schema 輸入，並將調用轉發到上游 API。響應（狀態碼、請求頭和 JSON/文本響應體）將原樣返回給 MCP 客戶端，以便你可以鏈式執行後續操作，例如輪詢任務狀態。