# mcp-bridge

Docker で MCP サーバを起動し、内部で llama.cpp の OpenAI 互換 API を呼び出す構成です。

## セットアップ

1. `.env.example` を `.env` にコピー
2. `MCP_API_TOKEN` を 32 文字以上のランダム値に設定
   ```bash
   echo "MCP_API_TOKEN=$(openssl rand -hex 32)" >> .env
   ```
3. 必要に応じて `LLAMA_CPP_SERVER_URL` をリモートの llama.cpp に向ける

## 起動

```bash
docker compose up -d --build
```

## 停止

```bash
docker compose down
```

## 接続先

- MCP エンドポイント: `http://localhost:8000/mcp`
- トランスポート: `streamable-http`

## 接続確認

認証が有効になっているため、Bearer トークンが必要です。
401 が返る場合は未認証、406 が返る場合は到達確認としては正常です
(MCP エンドポイントは Accept ヘッダー前提のため)。

```bash
# 未認証 -> 401
curl -i http://localhost:8000/mcp

# 認証あり -> 406 (到達OK)
curl -i -H "Authorization: Bearer $MCP_API_TOKEN" http://localhost:8000/mcp
```

## Claude Code 設定

Claude Code の MCP は `~/.claude.json` で管理されます。

ローカルスコープ（特定プロジェクトのみ）で手動設定する場合は、
`client-config.example.json` の形式を `~/.claude.json` に反映してください。

### 推奨: CLI で追加

```bash
claude mcp add --transport http local-agent-helper http://localhost:8000/mcp \
  --header "Authorization: Bearer $MCP_API_TOKEN"
```

### 設定確認

```bash
claude mcp list
claude mcp get local-agent-helper
```

### 補足

- `--scope user` を付けると全プロジェクトで利用可能です。
- `--scope project` を使うと、プロジェクト直下の `.mcp.json` に保存されます。

## 環境変数

`.env.example` を `.env` にコピーして利用できます。

- `MCP_TRANSPORT` (既定: `streamable-http`)
- `FASTMCP_HOST` (既定: `0.0.0.0`)
- `FASTMCP_PORT` (既定: `8000`)
- `LLAMA_CPP_SERVER_URL`
- `LLAMA_CPP_SERVER_MODEL`
- `LLAMA_CPP_SERVER_TIMEOUT`
- `MCP_API_TOKEN` (必須・32文字以上)
- `MAX_INPUT_CHARS` (既定: `200000`)