multiai-relay-mcp

# multiAI-relay-mcp **日本語** | [English](#english) Claude Desktop と Codex Desktop が MCP を通じて状態を共有し、セッションをまたいで作業を引き継げる協調開発システムです。 --- ## 特徴 - 🔁 **セッションリレー** — レートリミットや作業交代のタイミングで、担当 AI を切り替えながら作業を継続 - 📝 **永続的な共有状態** — メモ・決定事項・タスク・既知の問題を `AI_STATE.json` に記録し、セッションをまたいで保持 - 🔍 **横断検索** — メモ・決定・問題・タスクをキーワードで一括検索 - 🔒 **安全な並行書き込み** — ファイルロック＋アトミック書き込みで、Claude/Codex が同時に更新しても状態が壊れない - 🌐 **多言語対応 (i18n)** — `MULTIAI_LANG=en` で全ツールの出力・HANDOFF.md を英語に切り替え（デフォルトは日本語） - 🌿 **Git 統合** — `collab_status` / `collab_switch_project` でブランチ名と最新コミットを自動表示 - 🔤 **日本語文字コード診断** — `collab_encoding_report()` でUTF-8保存・表示コードページ・CLI入出力を切り分け - 🛡️ **stdio 安定化** — v1.1.4 以降、Git 情報取得の子プロセスは MCP stdio 入力を継承せず、Windows でも `collab_status` / `collab_switch_project` が詰まりにくい - 🧪 **堅牢な入力検証** — v1.1.5 以降、異常なJSON入力でもMCPサーバー例外や不正な `cli_config.json` 保存を防止 - 🧭 **非Gitプロジェクト対応** — v1.1.6 以降、既定の Codex CLI 呼び出しに `--skip-git-repo-check` を含め、git管理外フォルダでも相談系ツールが動作 - 📦 **プロジェクト外への書き込みを最小化** — 状態本体はプロジェクト内、直近プロジェクト情報のみホーム配下に保存 > **設計上の制約:** MCP サーバーは Desktop アプリごとに独立したプロセスとして起動されます。 > **1 プロセス = 1 セッションデフォルトプロジェクト** です。`collab_switch_project()` でセッション既定を設定し、個別ツール呼び出しでは `project_path=` で別プロジェクトを一時指定できます。 > 直近のプロジェクトは `~/.multiai_current_project.json` にも保存され、Desktop再起動後に復元されることがあります。複数プロジェクトを扱う場合、書き込み前に `collab_switch_project()` または `project_path=` で対象を明示してください。 > 詳細・復旧手順 → リポジトリ内 `docs/TROUBLESHOOTING.md` を参照 > 日本語文字化け対策 → リポジトリ内 `docs/ENCODING.md` を参照 --- ## セットアップ ### 前提条件 - [uv](https://docs.astral.sh/uv/) がインストール済みであること - Claude Desktop または Codex Desktop ### 1. Claude Desktop の設定 `%APPDATA%\Claude\claude_desktop_config.json` の `mcpServers` に追加: ```json "multiai-relay-mcp": { "command": "uvx", "args": ["multiai-relay-mcp"] } ``` > `uvx` のフルパスが必要な場合は `where uvx`（Windows）または `which uvx`（Mac/Linux）で確認。 > 追加後は Claude Desktop を再起動。 > 特定バージョンで固定したい場合は `args` を `["--from", "multiai-relay-mcp==1.1.6", "multiai-relay-mcp"]` のように指定できます。 ### 2. Codex Desktop の設定 `~/.codex/config.toml` の末尾に追加: `…