# crabeye-mcp-bridge

Routes multiple MCP servers through one connection, with searchable tools and execution rules. Useful when an assistant has too many MCP schemas in context.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 17
- Author: crabeye-ai
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/crabeye-ai/crabeye-mcp-bridge
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/crabeye-mcp-bridge

## What it does

crabeye-mcp-bridge places several MCP servers behind one STDIO connection. It builds an index with namespaces, then exposes two operations to the assistant: `search_tools` finds matching tools and `run_tool` invokes one. Other tool schemas stay out of the context until they are requested.

The bridge accepts STDIO, HTTP, and SSE upstreams. Rules can allow, ask for approval, or block execution at tool, server, or global scope. It also includes encrypted credential storage, `${credential:key}` references, the `auth <server>` OAuth flow for HTTP upstreams, and rate limiting.

Run `npx @crabeye-ai/crabeye-mcp-bridge init` to scan client configuration files and add the bridge. Without configured upstream servers, Claude Code surfaces a startup error in its MCP server log.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add crabeye-mcp-bridge -- npx -y @crabeye-ai/crabeye-mcp-bridge
```

### Codex

**Platform CLI**
```bash
codex mcp add crabeye-mcp-bridge -- npx -y @crabeye-ai/crabeye-mcp-bridge
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "crabeye-mcp-bridge": {
            "command": "npx",
            "args": [
                "-y",
                "@crabeye-ai/crabeye-mcp-bridge"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "crabeye-mcp-bridge": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@crabeye-ai/crabeye-mcp-bridge"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add crabeye-mcp-bridge npx -y @crabeye-ai/crabeye-mcp-bridge
```

## When to use it
- consolidate several MCP servers behind one connection
- search a growing MCP tool catalog
- control tool execution with approval policies
- store MCP credentials outside configuration files
- import existing client configurations into the bridge

## Example prompts
- Use `search_tools` to find a GitHub tool for this task.
- Call `run_tool` to execute the matching Linear tool with the task parameters.
- Search for available Slack tools, then choose one by its description.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md