AIbase

探索
Baryhuang MCP Server Any Openapi

Baryhuang MCP Server Any Openapi

一个可扩展的OpenAPI端点发现和API请求工具，通过语义搜索快速定位API端点并执行请求，特别适合处理大型OpenAPI文档。
开发者工具人工智能聊天机器人#API发现#语义搜索#请求工具#OpenAPI .Python
2.5分
1
2025-04-28 23:50:41
概述
安装
内容详情
替代品

什么是MCP服务器？

MCP服务器是一个轻量级工具，用于快速解析和搜索OpenAPI文档中的API端点。它通过自然语言查询帮助您找到所需的API，并生成完整的请求参数，从而简化与外部API的交互。

如何使用MCP服务器？

只需提供OpenAPI文档URL，MCP服务器即可自动生成API搜索工具和请求工具。您可以直接在客户端（如Claude Desktop）中调用这些工具来完成复杂的API请求。

适用场景

适合需要频繁调用复杂API的企业和个人开发者，例如金融、医疗、电商等领域。

主要功能

远程OpenAPI文档支持无需上传文件，直接通过URL访问您的API文档。
语义搜索利用MiniLM-L3模型进行高效的语义搜索，快速定位目标API。
异步API执行基于FastAPI的异步处理框架，确保高并发下的稳定运行。
端点级分块将API文档按端点拆分为小块，避免大文档带来的性能问题。

优势与局限性

优势
无需手动更新API文档，自动同步最新版本。
支持大规模API文档（可达10MB）。
提供详细的请求生成和执行能力。
局限性
不支持Linux ARM v7架构。
首次启动时模型加载时间较长（约15秒）。
当前镜像较大（无预下载模型时2GB，预下载后3.76GB）。

如何使用

部署MCP服务器使用Docker运行MCP服务器，指定OpenAPI文档URL和工具前缀。
配置Claude Desktop在Claude Desktop中添加MCP服务器地址并创建API请求工具。
发起API请求通过自然语言查询找到目标API，并生成完整的请求参数。

使用案例

案例1：获取股票价格通过自然语言查询找到股票价格API，并生成完整请求参数。
案例2：创建新用户通过查询创建新用户的API，并传递必要的参数。

常见问题

1
MCP服务器是否支持本地文件系统？否，MCP服务器仅支持通过URL访问远程OpenAPI文档。
2
如何优化MCP服务器的性能？可以通过减少模型大小或优化网络环境来提升性能。
3
是否有其他平台支持？目前支持Linux AMD64和ARM64架构。

相关资源

官方文档MCP服务器的GitHub仓库。
Docker HubMCP服务器的Docker镜像。
用户手册MCP服务器的使用指南。
精选MCP服务推荐
安装
复制以下命令到你的Client进行配置
{
  "mcpServers": {
    "finance_openapi": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OPENAPI_JSON_DOCS_URL=https://api.finance.com/openapi.json",
        "-e",
        "MCP_API_PREFIX=finance",
        "buryhuang/mcp-server-any-openapi:latest"
      ]
    },
    "healthcare_openapi": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OPENAPI_JSON_DOCS_URL=https://api.healthcare.com/openapi.json",
        "-e",
        "MCP_API_PREFIX=healthcare",
        "buryhuang/mcp-server-any-openapi:latest"
      ]
    }
  }
}

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

{
  "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"
      ]
    }
  }
}
注意：您的密钥属于敏感信息，请勿与任何人分享。