Content
# 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!
