MCP Bridge API
MCP Bridge is a lightweight, fast, and LLM-agnostic proxy for connecting to multiple Model Context Protocol (MCP) servers through a unified REST API. It enables secure tool execution across diverse environments like mobile, web, and edge devices. Des
What is MCP Bridge API?
MCP Bridge API is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp bridge is a lightweight, fast, and llm-agnostic proxy for connecting to multiple model context protocol (mcp) servers through a unified rest api. it enables secure tool execution across diverse en...
MCP Bridge is a lightweight, fast, and LLM-agnostic proxy for connecting to multiple Model Context Protocol (MCP) servers through a unified REST API. It enables secure tool execution across diverse environments like mobile, web, and edge devices. Des
This server falls under the APIs and Developer Tools categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP Bridge is a lightweight, fast, and LLM-agnostic proxy fo
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-bridge-apiConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCP Bridge API
MCP Bridge API is a lightweight, LLM-agnostic REST proxy that exposes multiple Model Context Protocol servers behind a single HTTP endpoint, making MCP tools accessible from environments where stdio transport is impractical — including mobile apps, web frontends, and edge devices. It handles connection management, risk-based execution controls, and optional Docker isolation, letting any HTTP client (not just Claude Desktop) call MCP tools through standard REST calls. Teams building React Native apps, web dashboards, or Python agents that need MCP tool access without embedding an MCP client can use this bridge as a central gateway.
Prerequisites
- Node.js 18 or higher for the bridge server
- Python 3.8 or higher if using the bundled Python agent
- Docker (optional, required only for high-risk tool isolation)
- Any MCP-compatible client or HTTP client to call the REST API
- The MCP servers you want to expose already installed on the same machine
Clone the repository
Clone the mcp-bridge-api repository to your machine and enter the project directory.
git clone https://github.com/INQUIRELAB/mcp-bridge-api.git
cd mcp-bridge-apiInstall Node.js dependencies
Install the required Express-based packages for the bridge server.
npm install express cors morgan uuidConfigure mcp_config.json
Create or edit mcp_config.json in the project root to declare which MCP servers the bridge should manage. Each entry specifies the command, arguments, optional environment variables, and a riskLevel (1=low/direct, 2=medium/confirm, 3=high/Docker).
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"],
"riskLevel": 2
},
"slack": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-slack"],
"env": {
"SLACK_BOT_TOKEN": "xoxb-your-token",
"SLACK_TEAM_ID": "T01234567"
},
"riskLevel": 1
}
}
}Start the bridge server
Launch the MCP Bridge API. By default it listens on port 3000.
node mcp-bridge.jsVerify the bridge is running
Check the health endpoint to confirm the server started and all configured MCP servers are connected.
curl http://localhost:3000/healthCall MCP tools via REST
Execute a tool on a connected MCP server using a POST request. Replace 'filesystem' and 'read_file' with the desired server ID and tool name.
curl -X POST http://localhost:3000/servers/filesystem/tools/read_file \
-H 'Content-Type: application/json' \
-d '{"path": "/tmp/example.txt"}'MCP Bridge API Examples
Client configuration
Example mcp_config.json declaring two MCP servers with different risk levels for the bridge to manage.
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"],
"riskLevel": 2
},
"slack": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-slack"],
"env": {
"SLACK_BOT_TOKEN": "xoxb-your-token",
"SLACK_TEAM_ID": "T01234567"
},
"riskLevel": 1
}
}
}Prompts to try
REST API calls and Python agent commands that demonstrate bridge capabilities.
- GET http://localhost:3000/servers — list all connected MCP servers
- GET http://localhost:3000/servers/filesystem/tools — list tools on the filesystem server
- POST http://localhost:3000/servers/filesystem/tools/list_directory {"path":"/tmp"} — run a tool
- GET http://localhost:3000/health — check bridge status
- python llm_test.py --mcp-url http://localhost:3000 — run the Python agent against the bridgeTroubleshooting MCP Bridge API
A configured MCP server fails to start when the bridge launches
Run the MCP server command manually (e.g. 'npx -y @modelcontextprotocol/server-filesystem /tmp') to see its error output. Common causes are missing packages or incorrect paths in mcp_config.json.
POST to a tool endpoint returns 'confirmation required'
The tool's riskLevel is set to 2 (medium). Send a POST to /confirmations/{confirmationId} with the confirmation payload returned in the original response to proceed with execution.
Port 3000 is already in use
Pass a custom port when starting: 'node mcp-bridge.js --port 3001', or update the Python agent with '--mcp-port 3001' to match.
Frequently Asked Questions about MCP Bridge API
What is MCP Bridge API?
MCP Bridge API is a Model Context Protocol (MCP) server that mcp bridge is a lightweight, fast, and llm-agnostic proxy for connecting to multiple model context protocol (mcp) servers through a unified rest api. it enables secure tool execution across diverse environments like mobile, web, and edge devices. des It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCP Bridge API?
Follow the installation instructions on the MCP Bridge API GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with MCP Bridge API?
MCP Bridge API works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCP Bridge API free to use?
Yes, MCP Bridge API is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
MCP Bridge API Alternatives — Similar APIs Servers
Looking for alternatives to MCP Bridge API? Here are other popular apis servers you can use with Claude, Cursor, and VS Code.
Kong
★ 43.4k🦍 The API and AI Gateway
API Mega List
★ 5.4kThis GitHub repo is a powerhouse collection of APIs you can start using immediately to build everything from simple automations to full-scale applications. One of the most valuable API lists on GitHub—period. 💪
Fetch
★ 5.4kFetch web content and convert to markdown for AI consumption
Fusio
★ 2.1kSelf-Hosted API Management for Builders
Korean Law
★ 1.8k국가법령정보MCP v4.0 | 법제처 41개 API → 17개 MCP 도구. 법령·판례·조례 검색 + LLM 환각 방지 인용검증 + 조문 영향 그래프(impact_map) + 시점 비교 자동 diff(time_travel) + 시민 5단계 실행 가이드(action_plan) | 41 Korean legal APIs → 17 MCP tools
RuleGo
★ 1.5k⛓️RuleGo is a lightweight, high-performance, embedded, next-generation component orchestration rule engine framework for Go.
Browse More APIs MCP Servers
Explore all apis servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up MCP Bridge API in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use MCP Bridge API?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.