MCP Server Any Openapi

一个可扩展的OpenAPI端点发现和API请求工具，通过语义搜索快速找到相关API端点并执行请求。

开发者工具金融 #API发现 #语义搜索 #OpenAPI #请求工具 .Python

评分 : 2.5分

下载量 : 7.2K

更新时间 : 2025-04-28

打开站点

什么是MCP服务器？

MCP服务器是一个用于快速发现和调用OpenAPI端点的工具，支持基于自然语言的API搜索，以及复杂的RESTful API请求执行。它无需本地文件系统访问，能够自动处理API更新。

如何使用MCP服务器？

只需提供OpenAPI文档URL，即可快速配置和运行服务器。通过自然语言查询API端点，并构造精确的请求。

适用场景

适用于需要高效调用API的企业级应用，特别是涉及多个API集成的场景。例如金融、医疗等领域的API管理。

主要功能

远程OpenAPI文档支持

无需本地文件系统访问，直接从远程URL加载OpenAPI文档。

语义搜索

基于优化的MiniLM-L3模型，快速找到与查询最相关的API端点。

异步API请求执行

通过FastAPI框架实现高性能API请求处理。

多实例支持

轻松配置多个API集，每个集独立运行。

优势

无需手动更新API文档

支持大规模API文档（高达10MB）

灵活的工具命名

快速冷启动（15秒内加载模型）

局限性

不支持Linux ARM/V7架构

依赖Hugging Face模型下载（网络中断可能影响启动）

当前版本较大（约3.76GB）

如何使用

安装Docker

确保您的环境中已安装Docker。

拉取镜像

从Docker Hub拉取MCP服务器镜像。

运行容器

通过环境变量指定API文档URL和工具前缀。

使用案例

案例1：获取股票价格

通过自然语言查询API端点，构造请求并获取响应。

案例2：创建新用户

使用自定义工具构造复杂请求并执行。

常见问题

MCP服务器是否支持多个API集？

如何解决冷启动延迟问题？

MCP服务器是否支持ARM架构？

🚀 MCP 服务器

MCP（Message Communication Protocol）服务器基于 FastAPI 实现，主要用于支持与 Claude Desktop 的交互。它可通过 Docker 运行，还支持多平台架构，为开发者提供了便利的使用体验。

🚀 快速开始

MCP 服务器能够帮助开发者轻松实现与 Claude Desktop 的交互。你可以通过以下步骤快速安装并运行它。

✨ 主要特性

多架构支持：官方镜像支持三种平台：linux/amd64、linux/arm64。
灵活的工具命名：可通过 MCP_API_PREFIX 控制工具名称。
OpenAPI 支持：能够处理 OpenAPI 规范，提取 API 端点信息并提供搜索功能。

📦 安装指南

使用预构建镜像（Docker Hub）

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

🔧 技术细节

核心组件

EndpointSearcher：核心类，处理以下功能：
- OpenAPI 规范解析
- 半检索索引创建
- 端点文档格式化
- 自然语言查询处理
服务器实现：
- 异步 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",
        "-e",
        "GLOBAL_TOOL_PROMPT='Access to insights apis for ACME Financial Services abc.com .",
        "buryhuang/mcp-server-any-openapi:latest"
      ]
    }
  }
}