# 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:
```bash
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:
```bash
export ANTHROPIC_API_KEY=your_api_key_here
```

### Build and run:
```bash
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):

```json
{
  "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!