Universal MCP Gateway
Docker for AI Tools - Connect anything to AI agents in one command
Project Overview
Universal MCP Gateway is an open-source gateway that automatically converts REST APIs, GraphQL APIs, databases, SDKs, and CLI tools into MCP (Model Context Protocol) compatible agent tools. Stop writing custom integrations—let the gateway do it for you.
The project addresses a critical challenge in AI development: MCP is rapidly becoming the standard interoperability layer for AI agents, but developers must manually create MCP servers for every integration. Universal MCP Gateway eliminates this bottleneck by automatically converting any data source or API into MCP-compatible tools that AI agents can use immediately.
The Challenge
The Problem: MCP is rapidly becoming the standard interoperability layer for AI agents, but developers must manually create MCP servers for every integration—a time-consuming and repetitive process.
The Solution: Universal MCP Gateway automatically converts any data source or API into MCP-compatible tools that AI agents can use immediately, eliminating manual integration work.
Key Features
Auto-generate MCP Tools
From Swagger/OpenAPI specifications
Database Introspection
PostgreSQL, MySQL, SQLite support
CLI-to-MCP Wrapper
Expose any command-line tool
Authentication Middleware
OAuth2, API Keys, JWT support
Secure Execution Sandbox
WASM isolation for safety
Auto-generated Docs
Documentation and web UI included
Technologies & Services
Project Impact
What Was Achieved
- Built a production-ready gateway that eliminates manual MCP server creation
- Implemented 7+ built-in adapters (OpenAPI, GraphQL, PostgreSQL, MySQL, SQLite, CLI, REST)
- Created TypeScript SDK with comprehensive error handling and type safety
- Developed secure execution sandbox using WASM for isolated tool execution
- Published open-source project with full documentation and examples
- Achieved 1K+ NPM package downloads demonstrating community adoption
- Implemented authentication middleware supporting OAuth2, API Keys, and JWT
- Built auto-generated documentation and web UI for tool management
- Enabled Docker deployment for one-command setup
- Created plugin architecture for custom adapter development
Architecture
┌─────────────────────────────────────────────────────────┐
│ AI Agent (Claude, GPT, etc.) │
└────────────────────┬────────────────────────────────────┘
│ MCP Protocol
┌────────────────────▼────────────────────────────────────┐
│ Universal MCP Gateway │
│ ┌──────────────────────────────────────────────────┐ │
│ │ Core Engine (Rust) │ │
│ │ - Protocol Handler │ │
│ │ - Tool Registry │ │
│ │ - Execution Sandbox (WASM) │ │
│ └──────────────────────────────────────────────────┘ │
│ ┌──────────────────────────────────────────────────┐ │
│ │ Adapters │ │
│ │ - OpenAPI/Swagger - GraphQL - PostgreSQL │ │
│ │ - MySQL - CLI Wrapper - Custom Plugins │ │
│ └──────────────────────────────────────────────────┘ │
└────────────────────┬────────────────────────────────────┘
│
┌────────────┼────────────┐
│ │ │
┌────▼───┐ ┌───▼────┐ ┌──▼─────┐
│ APIs │ │ DBs │ │ CLIs │
└────────┘ └────────┘ └────────┘Quick Start
Using Docker (Recommended)
docker run -p 8080:8080 -v ./config:/config universalmcp/gatewayUsing NPM SDK
npm install universal-mcp-gateway-sdk// Create client and execute toolsconst client = new MCPClient({ baseURL: 'http://localhost:8080' });const tools = await client.listTools();