mcp-stdio-proxy
Docker (DevContainer) から macOS ホストの Xcode MCP サーバー (xcrun mcpbridge) に接続するための TCP↔stdio ブリッジ。
Python 標準ライブラリのみで動作。追加依存なし。
アーキテクチャ```
[DevContainer] [Host macOS]
Claude Code xcode_mcp_bridge.py
└─ nc host.docker.internal ──► 127.0.0.1:8080
8080 (stdio) └─ spawn xcrun mcpbridge (per connection)
└─ XPC ──► Xcode
## 前提条件
- macOS + Xcode 26.3 以降
- Xcode 設定 → Intelligence → Model Context Protocol → **Xcode Tools を ON**
- Xcode を起動し、対象プロジェクトを開いておく
- `xcrun mcpbridge --help` が動くこと
## セットアップ
### 1. ブリッジ起動(手動)```bash
python3 xcode_mcp_bridge.py
2. 疎通確認```bash
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' \
| nc 127.0.0.1 8080
初回接続時に Xcode の Allow ダイアログが表示されるので許可する。
### 3. LaunchAgent で常駐化(オプション)
`launchagent/com.user.xcode-mcp-bridge.plist` 内の `USERNAME` を自分のユーザー名に置換してコピー:```bash
sed "s/USERNAME/$(whoami)/g" launchagent/com.user.xcode-mcp-bridge.plist \
> ~/Library/LaunchAgents/com.user.xcode-mcp-bridge.plist
launchctl load ~/Library/LaunchAgents/com.user.xcode-mcp-bridge.plist
4. DevContainer 側の設定
コンテナに netcat-openbsd が必要(なければ apt-get install -y netcat-openbsd)。
.mcp.json に追加:json
{
"mcpServers": {
"xcode": {
"command": "nc",
"args": ["host.docker.internal", "8080"]
}
}
}
トラブルシューティング
| 症状 | 原因候補 |
|---|---|
nc: getaddrinfo: Name or service not known |
host.docker.internal が未解決。--add-host=host.docker.internal:host-gateway を付ける |
| 接続はできるがツール一覧が空 | Xcode の Allow を押し損ねた、または Xcode Tools トグルが OFF |
| フリーズする | Xcode が落ちていないか確認 |
| 再接続のたびに Allow が出る | 仕様(新規接続=新規プロセス) |
License
MIT
