crabeye-mcp-bridge — Claude Code MCP server: setup
Routes multiple MCP servers through one connection, with searchable tools and execution rules. Useful when an assistant has too many MCP schemas in context.
claude mcp add crabeye-mcp-bridge -- npx -y @crabeye-ai/crabeye-mcp-bridgeWhat crabeye-mcp-bridge 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.
What it helps with
- 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 for the agent
- Use
search_toolsto find a GitHub tool for this task. - Call
run_toolto execute the matching Linear tool with the task parameters. - Search for available Slack tools, then choose one by its description.
How to install crabeye-mcp-bridge
Platform CLI
claude mcp add crabeye-mcp-bridge -- npx -y @crabeye-ai/crabeye-mcp-bridgePlatform CLI
codex mcp add crabeye-mcp-bridge -- npx -y @crabeye-ai/crabeye-mcp-bridgeConfig file
{
"mcpServers": {
"crabeye-mcp-bridge": {
"command": "npx",
"args": [
"-y",
"@crabeye-ai/crabeye-mcp-bridge"
]
}
}
}Config file
{
"servers": {
"crabeye-mcp-bridge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@crabeye-ai/crabeye-mcp-bridge"
]
}
}
}Platform CLI
gemini mcp add crabeye-mcp-bridge npx -y @crabeye-ai/crabeye-mcp-bridgeStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about crabeye-mcp-bridge
How do I install crabeye-mcp-bridge in Claude Code?
Run claude mcp add crabeye-mcp-bridge -- npx -y @crabeye-ai/crabeye-mcp-bridge.
What does crabeye-mcp-bridge do?
It puts multiple MCP servers behind one STDIO connection. The assistant discovers and invokes their tools through search_tools and run_tool, while policies govern execution.
What must be configured before it can run?
Add upstream MCP servers to the configuration. You can run npx @crabeye-ai/crabeye-mcp-bridge init to discover client configs; the bridge reads mcpServers, upstreamServers, servers, and context_servers.
