MCP-Gateway

What is MCP-Gateway?

MCP-Gateway is a service that provides unified MCP Server management, enabling AI Agents to connect to databases, REST APIs, and other external services without handling connection details. It is built for developers and AI agent systems that need to manage multiple MCP Server instances and route requests efficiently.

How to use MCP-Gateway?

Clone the repository, install Go dependencies with go mod tidy, and run go run cmd/server/main.go. The server starts on port 8080 by default (customizable via the PORT environment variable). Use the provided test clients (go run test/client.go, test/curl/curl_client.go, test/openapi/openapi_client.go) to interact with HTTP and OpenAPI conversion features.

Key features of MCP-Gateway

• HTTP interface management with OpenAPI import/export and versioning
• Convert curl commands into structured HTTP interfaces
• MCP Server metadata management, version control, and WebAssembly compilation
• Routing rule configuration (e.g., pattern matching xxx/mcp-server/{name})
• Dynamic activation and tool invocation on compiled MCP Servers

Use cases of MCP-Gateway

• AI agents requiring unified access to multiple external APIs and databases
• Converting legacy curl-based API calls into managed MCP Server endpoints
• Importing or exporting OpenAPI 3.0.0 specifications for compatibility with existing API frameworks
• Enabling versioned, hot-reloadable MCP Servers via WebAssembly deployment
• Centralized route management for services with dynamic server instances

FAQ from MCP-Gateway

What is MCP-Gateway and who is it for?

MCP-Gateway is a service for unified MCP Server management. It helps AI Agents connect to databases, REST APIs, and other external services. It is designed for developers building AI agent pipelines that need to manage multiple data sources.

What are the prerequisites for running MCP-Gateway?

You need Go 1.19 or higher and Git. Dependencies are managed via go mod tidy.

How can I convert curl commands into HTTP interfaces?

Send a POST request to /api/http-interfaces/from-curl with a JSON body containing the command, name, and optional description. The system parses the curl command and creates a properly formatted HTTP interface.

How can I import or export OpenAPI specifications?

Export: GET /api/http-interfaces/:id/openapi returns an OpenAPI 3.0.0 spec. Import: POST /api/http-interfaces/from-openapi with a JSON body containing name, description, and an OpenAPI spec object. The system creates HTTP interfaces for each path/operation.

What is the default port and how do I change it?

The server starts on port 8080 by default. Set the PORT environment variable to customize it.