
Claude Code Bridge
from SobieskiCodes
A bridge server connecting Claude Desktop with the Claude Code agent API.
MCP-Claude Code Bridge Setup
3. Configure Claude Desktop
Add to your Claude Desktop MCP settings (~/Library/Application Support/Claude/claude_desktop_config.json on Mac):
{
"mcpServers": {
"claude-code-bridge": {
"command": "node",
"args": ["/path/to/your/mcp-claude-bridge/server.js"],
"env": {
"ANTHROPIC_API_KEY": "your_api_key_here"
}
}
}
}4. Test with Cat Facts App
Once connected, tell Claude Desktop:
"Create a simple cat facts app using the claude_code_task tool. The app should fetch facts from catfacts.ninja and display them in a simple web interface."
5. Available Tools
The bridge provides these tools:
claude_code_task: Execute coding tasks via Claude Codecreate_project: Create new project directorieslist_files: List files in projectsread_file: Read file contentsrun_command: Execute shell commands
1. Prerequisites
- Docker and Docker Compose installed
- Claude Code CLI installed (
npm install -g @anthropic-ai/claude-code) - Anthropic API key
2. Setup Steps
Create project directory:
mkdir mcp-claude-bridge
cd mcp-claude-bridgeCreate the files:
Save all the provided artifacts as files in your project directory:
Dockerfilepackage.jsonserver.jsdocker-compose.yml
Set environment variable:
export ANTHROPIC_API_KEY=your_api_key_hereBuild and run:
docker-compose up --buildExample Usage
In Claude Desktop, you can now say:
- "Create a new React app that fetches cat facts"
- "Build a simple API server in Express"
- "Debug this Python script for me"
The MCP server will delegate complex tasks to Claude Code while keeping everything in the Desktop interface!
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.