Baryhuang MCP Server Any Openapi

🚀 MCP 服務器

MCP 服務器基於 FastAPI 構建，支持與 Claude Desktop 集成的 MCP 協議。它藉助自然語言處理技術，實現對 API 的理解與調用。該服務器可解析 OpenAPI 規範，生成語義索引，還能依據用戶的自然語言查詢，推薦合適的 API 端點。

✨ 主要特性

• OpenAPI 解析：支持解析標準的 OpenAPI 3.x 規範，能處理包含數千個端點的大型規範文件。
• 語義搜索：利用優化的嵌入模型（如 sentence-transformers），為每個 API 端點生成語義表示，並根據用戶的自然語言查詢進行匹配。
• 自動推薦：基於語義相似度，推薦最相關的 API 端點、請求方法和參數信息。
• 文檔生成：能夠自動生成結構化的 API 文檔，包括路徑、方法、參數和響應格式等詳細信息。

📦 安裝指南

使用預構建鏡像

docker pull buryhuang/mcp-server-any-openapi:latest

本地開發構建

docker build -t mcp-server-any-openapi .

啟動容器

docker run \
  -e OPENAPI_JSON_DOCS_URL=https://api.example.com/openapi.json \
  -e MCP_API_PREFIX=finance \
  buryhuang/mcp-server-any-openapi:latest

🔧 技術細節

關鍵組件

1. EndpointSearcher：核心類，負責：
   • OpenAPI 規範解析
   • 語義搜索索引創建
   • 端點文檔格式化
   • 自然語言查詢處理
2. 服務器實現：
   • 異步 FastAPI 服務器
   • MCP 協議支持
   • 工具註冊和調用處理

實現說明

• 基於端點的處理：與基於文檔的整體分析不同，我們通過以下方式為每個端點生成唯一的標識符：
  • 路徑 + 方法
  • 參數感知嵌入
  • 響應模式上下文
• 優化規範處理：通過以下方式處理 OpenAPI 規範（支持高達 10MB 的規範文件，約 5,000 個端點）：
  • 惰性加載方案組件
  • 並行解析路徑項
  • 選擇性生成嵌入（忽略冗餘描述）

📚 詳細文檔

集成與配置

在 Claude Desktop 中配置 MCP 服務器：

{
  "mcpServers": {
    "any_openapi": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OPENAPI_JSON_DOCS_URL=https://api.example.com/openapi.json",
        "-e",
        "MCP_API_PREFIX=finance",
        "buryhuang/mcp-server-any-openapi:latest"
      ]
    }
  }
}

貢獻指南

1. 叉倉庫
2. 創建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 打開 Pull Request

📄 許可證

該項目根據 LICENSE 文件中的條款進行許可。