In-depth architectural comparison of the MCP Claude Code and Claude MCP Bridge MCP servers. Compare execution transports, security boundaries, tool capabilities, quality scores, and ready-to-paste client installation snippets for Claude, Cursor, Windsurf, and VS Code.
At a Glance & Executive Verdict
MCP Claude Code
Coding Agents · Local stdio
Quality: 49/100 (Fair) | Auth: No auth required
Claude MCP Bridge
Coding Agents · Local stdio
Quality: 64/100 (Good) | Auth: other
Verdict Summary: Choose MCP Claude Code if you need specialized Coding Agents tools running via a local process. Choose Claude MCP Bridge if your workspace requires Coding Agents integration with local subprocess execution. Both servers can be configured concurrently in your client's mcpServers manifest.
Which MCP Server Should You Choose?
Choose MCP Claude Code when:
You need dedicated capabilities in the Coding Agents domain.
You prefer local stdio subprocess transport architecture.
Your security boundary fits: No auth required (Free / Open Source).
An implementation of Claude Code capabilities using MCP, enabling AI code understanding, modification, and project analysis with comprehensive tool support.
Wraps Claude Code CLI as MCP tools (query, search, structured, sessions) with subscription-first auth, cost metadata, budget caps, and granular tool sandboxing.
Category & Scope
Tools & Capabilities Breakdown
MCP Claude Code Tools (16)
read
Read file contents with line numbers, offset, and limit capabilities
write
Create or overwrite files
edit
Make line-based edits to text files
multi_edit
Make multiple precise text replacements in a single file operation with atomic transactions
directory_tree
Get a recursive tree view of directories
grep
Fast pattern search in files with ripgrep integration for best performance ([docs](./doc/migration_SearchContentTool_to_Grep.md))
Ready-to-Paste Client Configurations
Paste either (or both) of these JSON server blocks into your client config file (e.g. claude_desktop_config.json or ~/.cursor/mcp.json).
MCP Claude Code is categorized under Coding Agents and uses a local stdio subprocess. In contrast, Claude MCP Bridge belongs to Coding Agents using local stdio subprocess. Select MCP Claude Code when you need capabilities focused on coding agents and Claude MCP Bridge when you require tools for coding agents.
Search code with AST context showing matches within functions, classes, and other structures
run_command
Execute shell commands (also used for directory creation, file moving, and directory listing)
notebook_read
Extract and read source code from all cells in a Jupyter notebook with outputs
notebook_edit
Edit, insert, or delete cells in a Jupyter notebook
think
Structured space for complex reasoning and analysis without making changes
+4 more tools listed on main page
Claude MCP Bridge Tools (5)
query
Execute a prompt via Claude Code CLI with optional file context and session resume. Claude is an AI coding agent that can generate, analyze, refactor, and explain code.
Capabilities: code generation and refactoring, code analysis and explanation, file understanding (text and images), multi-turn conversations via sessionId.
Cost: Default model is Sonnet (~$0.01-0.10/call). Use effort="low" for simple tasks, effort="high" + model="opus" for complex analysis. Set maxBudgetUsd to cap per-call cost (recommended for effort="max" or model="opus").
Tips:
- Set workingDirectory to the target repo for project-aware responses.
- Break complex tasks into focused prompts rather than one large request.
- Resume multi-turn conversations with sessionId from a previous response's metadata.
- Include relevant files via the files parameter for targeted context (text files inlined in prompt, images trigger allowed-tools mode).
- Use noSessionPersistence=true for stateless one-shot calls.
structured
Generate JSON conforming to a provided JSON Schema. Uses Claude CLI's native --json-schema flag for validated output (not client-side validation).
Use for: data extraction from text/files, classification, entity parsing, or any task needing machine-parseable output.
Cost: Similar to query (~$0.01-0.10/call). Schema complexity doesn't significantly affect cost.
Tips:
- Pass the JSON Schema as a JSON string in the schema parameter.
- Schema max size: 20KB. Keep schemas focused for reliable output.
- For extraction tasks, include source text via the files parameter or inline in the prompt.
search
Web search via Claude Code CLI using WebSearch and WebFetch tools. Searches the web and synthesizes a comprehensive answer with source URLs.
Use for: current information, documentation lookups, API references, comparing libraries, and research questions.
Cost: Typically ~$0.02-0.05/search with Sonnet.
Tips:
- Ask specific, focused questions for best results.
- Results include source URLs for verification.
- Use maxResponseLength to control response verbosity.
- Increase timeout for complex research queries that may require multiple web fetches.
listSessions
List active Claude CLI sessions tracked by this server. Returns session metadata (IDs, models, timing, turn counts, cumulative cost) for orchestration. Use to check available sessions before resuming with sessionId. No cost (local lookup only).
ping
Health check: verifies Claude CLI is installed and authenticated, reports versions, capabilities, and configuration. No cost (local check only).