MCP Server: Scalable OpenAPI Endpoint Discovery and API Request…

@baryhuang

代码仓库

基本信息

分类

开发工具

许可证

MIT

传输方式

stdio

作者

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

MCP Server: Scalable OpenAPI Endpoint Discovery and API Request Tool 配置

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

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

MCP Server: Scalable OpenAPI Endpoint Discovery and API Request Tool 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 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

常见问题

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 服务器

SSH MCP Server

hypnosis

SSH MCP server for AI agents: remote commands, file transfer, log search and server audits through OpenSSH.

Moxie Docs

Jackalope-Dev

Automated codebase documentation for GitHub: searchable docs, MCP context for AI agents, doc drift detection, and Friday Cleanup PRs.

Nebelus

Nebelus is an enterprise agentic-AI platform for regulated industries. This MCP server exposes the Nebelus Construction API: ~48 tools that give an MCP client full agent build parity — create/update/probe agents, edit ag

LastPing

Know when your AI agents, cron jobs and CI pipelines fail, stall or go quiet. Your agent sets up monitors from a plain description, tells you what is broken and why, reads run history and traces, and writes notes on inci