MCP Server: Scalable OpenAPI Endpoint Discovery and API Request Tool

Name: MCP Server: Scalable OpenAPI Endpoint Discovery and API Request Tool
Author: baryhuang

@baryhuang

关于 MCP Server: Scalable OpenAPI Endpoint Discovery and API Request Tool

A MCP server that enables Claude to discover and call any API endpoint through semantic search. Intelligently chunks OpenAPI specifications to handle large API documentation, with built-in request execution capabilities. Perfect for integrating private APIs with Claude Desktop.

#openapi #semantic-search #faiss #mcp-server

基本信息

分类

开发工具

许可证

MIT

运行时

python

传输方式

stdio

发布者

baryhuang

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-server-any-openapi": {
      "command": "docker",
      "args": [
        "run",
        "-e",
        "MCP_API_PREFIX=finance",
        "..."
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is MCP Server: Scalable OpenAPI Endpoint Discovery and API Request Tool?

This MCP server enables natural-language discovery and invocation of REST API endpoints from a remote OpenAPI JSON specification. It uses in‑memory semantic search to find relevant endpoints even in large specs (100 KB+), then constructs and executes the corresponding HTTP requests. Designed for developers who want Claude Desktop or other MCP clients to interact with private, large OpenAPI‑defined APIs.

How to use MCP Server: Scalable OpenAPI Endpoint Discovery and API Request Tool?

Install via pip install mcp-server-any-openapi or run the Docker image buryhuang/mcp-server-any-openapi:latest. Configure with environment variables: OPENAPI_JSON_DOCS_URL (remote OpenAPI JSON), MCP_API_PREFIX (tool naming), and optionally GLOBAL_TOOL_PROMPT to help the model select the right tools. Then register the server in your MCP client (e.g., Claude Desktop) using the Docker command template provided in the README. The server exposes two tools: {prefix}_api_request_schema to discover endpoints and {prefix}_make_request to execute them.

Key features of MCP Server: Scalable OpenAPI Endpoint Discovery and API Request Tool

🧠 Remote OpenAPI JSON as source – no local file updates needed
🔍 Semantic search with optimized MiniLM‑L3 model (43 MB)
⚡ In‑memory FAISS vector search for instant endpoint discovery
🧠 Endpoint‑based chunking handles 100 KB+ OpenAPI specs losslessly
🚀 Async FastAPI server with MCP protocol support
🐳 Multi‑architecture Docker images (linux/amd64, linux/arm64)

Use cases of MCP Server: Scalable OpenAPI Endpoint Discovery and API Request Tool

Ask Claude to “get user profile” or “create a new job posting” against a large private API
Serve multiple independent API sets by running separate server instances with different prefixes
Automate API testing by letting an MCP client discover and invoke endpoints from natural‑language instructions
Override base URLs for staging or dev environments without changing the OpenAPI spec

FAQ from MCP Server: Scalable OpenAPI Endpoint Discovery and API Request Tool

How does this server differ from standard “fetch” or “make request” tools?

Standard tools often fail when the OpenAPI spec is hundreds of kilobytes. This server uses endpoint‑centric semantic search to find the correct endpoint and returns full parameter context, then makes the actual request. It was created specifically to solve the “spec too large” problem.

What are the runtime dependencies and cold start time?

Requires Python or Docker. The first start may need to download the MiniLM‑L3 model (pre‑embedded in the Docker image). Cold start penalty is roughly 15 seconds for model loading if not using the Docker image.

Can I run multiple API sets simultaneously?

Yes. Run multiple instances of the server, each with a different MCP_API_PREFIX and OPENAPI_JSON_DOCS_URL. Example configurations for “finance” and “healthcare” APIs are provided in

开发工具分类下的更多 MCP 服务器

DevDocs by CyberAGI 🚀

cyberagiinc

Completely free, private, UI based Tech Documentation MCP server. Designed for coders and software developers in mind. Easily integrate into Cursor, Windsurf, Cline, Roo Code, Claude Desktop App

2.1K

Golf

golf-mcp

Production-Ready MCP Server Framework • Build, deploy & scale secure AI agent infrastructure • Includes Auth, Observability, Debugger, Telemetry & Runtime • Run real-world MCPs powering AI Agents

834