MCP Server: Scalable OpenAPI Endpoint Discovery and API Request Tool
2025.04.15
26
PythonAPI工具OpenAPI开发效率
MCP Server: Scalable OpenAPI Endpoint Discovery and API Request Tool 是一个用于发现和调用OpenAPI端点的工具，特别适用于处理大型OpenAPI文档。它通过语义搜索快速找到相关API端点，并支持完整的API请求构造和执行。
View on GitHub
Overview
基本能力
产品定位
MCP Server: Scalable OpenAPI Endpoint Discovery and API Request Tool 是一个用于发现和调用OpenAPI端点的工具，特别适用于处理大型OpenAPI文档。
核心功能
- 🧠 使用远程OpenAPI JSON文件作为源，无需本地文件系统访问
- 🔍 使用优化的MiniLM-L3模型进行语义搜索（43MB vs 原始90MB）
- 🚀 基于FastAPI的服务器，支持异步
- 🧠 基于端点的OpenAPI规范分块处理（处理100KB+文档），不丢失端点上下文
- ⚡ 内存中的FAISS向量搜索，实现即时端点发现
适用场景
- 处理大型OpenAPI文档
- 快速发现和调用API端点
- 需要语义搜索API端点的场景
工具列表
- {prefix}_api_request_schema
- 获取与意图匹配的API端点模式。返回端点详细信息，包括路径、方法、参数和响应格式。
- {prefix}_make_request
- 执行复杂的API请求，提供完整的请求构造和执行能力。
常见问题解答
- 不支持linux/arm/v7（在Transformer库上构建失败）
- 冷启动惩罚（约15秒用于模型加载），如果不使用docker镜像
- 当前docker镜像禁用了模型下载，依赖huggingface
使用教程
使用依赖
无特别的前置依赖，但需要安装Docker或Python环境。
安装教程
通过Smithery安装
npx -y @smithery/cli install @baryhuang/mcp-server-any-openapi --client claude
使用pip安装
pip install mcp-server-any-openapi
使用Docker安装
docker pull buryhuang/mcp-server-any-openapi:latest
调试方式
运行容器
docker run \
-e OPENAPI_JSON_DOCS_URL=https://api.example.com/openapi.json \
-e MCP_API_PREFIX=finance \
buryhuang/mcp-server-any-openapi:latest
从源代码运行
python -m mcp_server_any_openapi