MCP Server: Scalable OpenAPI Endpoint Discovery and API Request Tool
2025.02.17
1
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文档。它通过语义搜索快速找到相关API端点，并支持构造和执行API请求。
核心功能
- 🧠 使用远程OpenAPI JSON文件作为源，无需本地文件系统访问
- 🔍 使用优化的MiniLM-L3模型进行语义搜索
- 🚀 基于FastAPI的服务器，支持异步
- 🧠 基于端点的OpenAPI规范分块处理（支持100KB+文档）
- ⚡ 内存中的FAISS向量搜索，实现即时端点发现
适用场景
- 处理大型OpenAPI文档
- 快速发现和调用API端点
- 需要语义搜索API端点的场景
工具列表
{prefix}_api_request_schema
获取与意图匹配的API端点模式。返回端点详细信息，包括路径、方法、参数和响应格式。
{prefix}_make_request
用于可靠执行复杂API请求的工具。提供完整的请求构造和执行能力。
常见问题解答
- 不支持linux/arm/v7（在Transformer库上构建失败）
- 冷启动时间较长（约15秒用于模型加载）
- 依赖huggingface下载模型，如果huggingface不可用，服务器将无法启动
使用教程
使用依赖
无特殊依赖，直接安装即可。
安装教程
通过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