MCP-Bridge

A middleware to provide an openAI compatible endpoint that can call MCP tools

Catalog onlyCatalog onlySTDIO

Overview

MCP-Bridge is a middleware that provides an OpenAI compatible endpoint to call MCP tools, enabling developers to integrate MCP tools seamlessly with the OpenAI API.

To use MCP-Bridge, install it via Docker or manually, configure the necessary settings in the config.json file, and run the service. Once running, you can interact with it using the OpenAI API.

Non-streaming and streaming chat completions with MCP - Integration with various MCP tools - SSE Bridge for external clients - REST API endpoints for interacting with MCP primitives

Integrating MCP tools with OpenAI API for enhanced functionality.
Facilitating communication between different AI models and tools.
Testing configurations and tool availability through the SSE Bridge.

Add to your AI client

Use these steps to connect MCP-Bridge in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "mcp-bridge-secretiveshell": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-bridge-secretiveshell"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "mcp-bridge-secretiveshell": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-bridge-secretiveshell"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "mcp-bridge-secretiveshell": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-bridge-secretiveshell"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "mcp-bridge-secretiveshell": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-bridge-secretiveshell"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-bridge-secretiveshell": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-bridge-secretiveshell"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "mcp-bridge-secretiveshell": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-bridge-secretiveshell"
      ]
    }
  }
}

FAQ

What is the recommended installation method?

The recommended way to install MCP-Bridge is using Docker, but manual installation is also possible.

How can I test if my configuration is working?

You can use the SSE endpoint to check the availability of MCP tools and test your configuration.

Is there documentation available?

Yes, documentation is available at [http://yourserver:8000/docs].

Research and data