mcpserver.so LogoMCPFly
Submit
MCP Server: Scalable OpenAPI Endpoint Discovery and API Request Tool logo

MCP Server: Scalable OpenAPI Endpoint Discovery and API Request Tool

by baryhuang

API/Clients & IntegrationOpenAPISemantic SearchAPI DiscoveryFastAPIClaude Desktop

MCP Server is a tool designed to serve private APIs with large OpenAPI specifications. It uses in-memory semantic search to find relevant API endpoints by natural language and returns complete endpoint documentation, enabling seamless integration with tools like Claude Desktop.

View on GitHub

Last updated: N/A

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

MCP Server is a FastAPI-based server that provides scalable OpenAPI endpoint discovery and API request capabilities. It leverages semantic search and in-memory indexing to efficiently handle large OpenAPI specifications and enable natural language-based API endpoint retrieval.

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

  1. Deploy the server using Docker or by running from source. 2. Configure the server with the URL of your OpenAPI JSON document using the OPENAPI_JSON_DOCS_URL environment variable. 3. Optionally, customize the tool namespace using the MCP_API_PREFIX environment variable. 4. Integrate the server with Claude Desktop or other tools by configuring the MCP server settings.

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

  • Uses remote OpenAPI JSON file as source

  • Semantic search using optimized MiniLM-L3 model

  • FastAPI-based server with async support

  • Endpoint-based chunking OpenAPI specs

  • In-memory FAISS vector search for instant endpoint discovery

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

  • Integrating large OpenAPI specifications with Claude Desktop

  • Enabling natural language-based API endpoint discovery

  • Serving private APIs with complex documentation

  • Automating API request execution with tools like Claude

  • Creating multi-instance configurations for multiple API sets

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

How do I configure the server to use my OpenAPI specification?

Set the OPENAPI_JSON_DOCS_URL environment variable to the URL of your OpenAPI JSON document.

How do I customize the tool names?

Use the MCP_API_PREFIX environment variable to specify a prefix for the tool names.

What are the available tools provided by the server?

The server provides two tools: {prefix}_api_request_schema for retrieving API endpoint schemas and {prefix}_make_request for executing API requests.

How do I integrate the server with Claude Desktop?

Configure the MCP server settings in Claude Desktop with the server's address and the appropriate tool names.

What platforms are supported?

The official images support linux/amd64 and linux/arm64 platforms.