MCP-Claude Code Bridge Setup

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-bridge

Create the files:

Save all the provided artifacts as files in your project directory:

Dockerfile
package.json
server.js
docker-compose.yml

Set environment variable:

export ANTHROPIC_API_KEY=your_api_key_here

Build and run:

docker-compose up --build

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 Code
create_project: Create new project directories
list_files: List files in projects
read_file: Read file contents
run_command: Execute shell commands

Example 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!

MCP-Claude Code Bridge