Claude Ipc MCP

🚀 Claude IPC MCP - AI間通信

Claude IPC MCPは、CLIベースのAIアシスタントがIPC（Inter-Process Communication）を使用して相互に通信するためのMCP（Model Context Protocol）です。このプロトコルにより、AI同士が自然言語でやり取りし、メッセージの永続化やセキュリティ対策を備えた通信が可能になります。

🚀 クイックスタート

v1.xからのアップグレード: 重要な変更点については移行ガイドを参照してください。

🔐 ステップ1: セキュリティ設定 (必須)

すべてのAIが通信するためには、同じ共有シークレットを使用する必要があります。

# オプション1: 現在のセッションに設定
export IPC_SHARED_SECRET="your-secret-key-here"

# オプション2: 永続的に設定 (推奨)
echo 'export IPC_SHARED_SECRET="your-secret-key-here"' >> ~/.bashrc
source ~/.bashrc

⚠️ 重要: 最初に起動するAIがセキュリティの有効化を決定します。シークレットが設定されていない場合は、オープンモード（最適ではないが利用可能）になります。

📚 完全な設定ガイド: 詳細な手順についてはSETUP_GUIDE.mdを参照してください。

ステップ2: Claude Codeユーザー向け

1. UVをインストールする（まだインストールされていない場合）:

curl -LsSf https://astral.sh/uv/install.sh | sh

2. MCPをインストールする:

cd claude-ipc-mcp
uv sync  # 依存関係をインストールする
./scripts/install-mcp.sh

3. Claude Codeを再起動する（セキュリティ付きでMCPを読み込むため）

4. インスタンスを登録する（重要 - 覚えておいてください - AIアシスタントには任意の名前を付けることができます。以下の'claude'は例です）

Register this instance as claude

5. メッセージの送受信を開始する:

Send a message to fred: Hey, need help with this React component
Check my messages
msg barney: The database migration is complete

6. 自動チェックを有効にする（オプション）:

Start auto checking 5

これで、AIは5分ごとに自動的にメッセージをチェックします！

自然言語コマンドは自動的に解釈されます。

ステップ3: Windsurf IDEユーザー向け

詳細な設定手順については、専用のWindsurf統合ガイドを参照してください。WindsurfのAIアシスタント（Cascade）は、Claude Codeや他のAIと通信することができます！

ステップ4: その他のAI（Google Geminiなど）向け

オプションA: 自然言語（推奨） Google GeminiやPythonを実行できる任意のAIで動作します - ただし、最初にコードをインストールしてください！

Register this instance as gemini
Send a message to claude: Hey, can you help with this?
Check my messages

オプションB: 直接Pythonスクリプト（フォールバック方法）

自然言語が機能しない場合、または直接実行を好む場合は、以下の方法を使用します。

# 共有シークレットが設定されていることを確認する（ステップ1を参照）
echo $IPC_SHARED_SECRET  # シークレットが表示されるはず

# まず、コードがAIの環境にインストールされていることを確認する
cd claude-ipc-mcp/tools

# 次に、スクリプトを直接使用する（ただし、インストール後は自然言語が推奨されます）
python3 ./ipc_register.py gemini
python3 ./ipc_send.py claude "Hey Claude, can you review this?"
python3 ./ipc_check.py

注意: ツールが設定された後は、Pythonを実行できるすべてのAIが自然言語コマンドを使用できます。

✨ 主な機能

Claude IPC MCPは、以下の機能を備えたAIエージェント間の通信を可能にします。

• 💬 自然言語コマンド - 「Register this instance as claude」（または任意の名前）と入力するだけです。
• 🔮 未来のメッセージング - まだ存在しないAIにメッセージを送信できます！
• 💾 SQLiteによる永続化 - 自動データベースバックアップにより、サーバー再起動後もメッセージが保存されます。
• 🔄 ライブリネーム - 自動転送機能で、オンザフライでアイデンティティを変更できます。
• 📦 スマートな大規模メッセージ - 10KBを超えるメッセージは自動的にファイルに変換されます。
• 🌍 クロスプラットフォーム - Claude Code、Windsurf、Gemini、およびPythonをサポートする任意のAIで動作します。
• 🏃 常時稼働 - クラッシュ回復とメッセージの耐久性を備えた24/7サーバー。
• 🤖 自動チェック - 「start auto checking 5」と言うだけで、メッセージを見逃すことはありません！（有効/無効を切り替えることができます）
• 🔐 セッションセキュリティ - 認証トークンによりメッセージが保護されます。
• ⚡ UVパッケージ管理 - 高速で最新のPython依存関係管理。

📦 インストール

必要条件

• Python 3.12以上（UVに必要）
• Claude CodeまたはPython実行機能を備えた任意のAI
• UVパッケージマネージャー（クイックスタートを参照）

⚠️ 重要: クリーンインストール

古いpip/venvインストールがある場合は、最初にクリーンアップしてください。

rm -rf venv/ .venv/  # 古い仮想環境を削除する

完全なセットアップ

1. このリポジトリをクローンする
2. UVをインストールする: curl -LsSf https://astral.sh/uv/install.sh | sh
3. 共有シークレットを設定する: export IPC_SHARED_SECRET="your-secret-key"
4. uv syncを実行し、次に./scripts/install-mcp.shを実行する
5. Claude Codeを完全に再起動する
6. コラボレーションを開始する！

💻 使用例

基本的な使用法

# インスタンスを登録する
Register this instance as barney
# メッセージを送信する
Send to nessa: Welcome to the team! I'm Barney, the troubleshooter.
# メッセージを確認する
Check messages

高度な使用法

# インスタンス名を変更する
rename to fred-debugging
# 大規模なメッセージを送信する
msg claude: [20KB of debug logs]

📚 ドキュメント

必須ガイド

• 🚀 セットアップガイド - 完全なインストールガイド
• 🔐 セキュリティクイックスタート - セキュリティ設定
• 🏗️ アーキテクチャ - 技術的な設計詳細
• 🤖 自動チェックガイド - 手動でメッセージを確認する必要はありません！
• 🤝 AI統合ガイド - 任意のAIプラットフォームを接続する
• 🔄 サーバー冗長性 - 継続性についての理解
• 🤖 Geminiセットアップ - Google Geminiユーザー向けの簡単なガイド
• 🛠️ トラブルシューティング - 一般的な問題の解決策

クイックリファレンス

• APIリファレンス - プロトコル仕様
• サンプル - 統合例

🔧 技術詳細

v2.0.0の新機能

• ✅ 追加のセキュリティ監査 - すべての重大な脆弱性が修正されました。
• ✅ 安全なデータベース場所 - メッセージは適切なパーミッションを持つ~/.claude-ipc-dataに保存されます。
• ✅ 強化されたセキュリティ - トークンのハッシュ化、有効期限、およびレート制限。
• ✅ 改善されたドキュメント - 包括的なトラブルシューティングガイドと移行ガイド。
• 📖 完全な変更履歴を参照 | 📋 移行ガイド

セキュリティ

• セッションベースの認証により、なりすましが防止されます。
• すべてのメッセージでアイデンティティの検証が行われます。
• レート制限により、悪用が防止されます。
• デフォルトでローカルのみの接続。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。自由に使用、拡張し、AI同士を会話させてください！