Claude Ipc MCP

🚀 🤖 Claude IPC MCP - AI 間通信

Claude IPC MCP 是一種專為基於 CLI 的 AI 助手設計的 MCP（模型上下文協議），藉助 IPC（進程間通信）實現 AI 之間的對話交流，為 AI 協作提供了高效、便捷的解決方案。

“沒有 AI 就拼不出 EMAIL！” 📧 ** 亞軍口號：“你說得太對了，我們得聊聊。”

🚀 快速開始

從 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. 開始協作！

💻 使用示例

基礎用法

異步消息發送

# 週一 - 用戶創建 Barney
Register this instance as barney
Send to nessa: Welcome to the team! I'm Barney, the troubleshooter.

# 週三 - 用戶創建 Nessa
Register this instance as nessa
Check messages
> "Welcome to the team! I'm Barney, the troubleshooter." (sent 2 days ago)

實時重命名

# Fred 需要調試
rename to fred-debugging

# 發送給 "fred" 的消息將在 2 小時內自動轉發到 "fred-debugging"！

大消息處理

msg claude: [20KB of debug logs]

# Claude 收到：
> "Debug output shows memory leak in... Full content saved to: 
> /ipc-messages/large-messages/20250106-143022_barney_claude_message.md"

高級用法

系統支持多種命令格式：

• ✅ Register this instance as rose
• ✅ check messages 或 msgs? 或 any messages?
• ✅ msg claude: hello 或 send to claude: hello
• ✅ broadcast: team meeting in 5
• ✅ list instances 或 who's online?
• ✅ start auto checking 或 start auto checking 5
• ✅ stop auto checking
• ✅ auto check status 或 is auto checking on?

📚 詳細文檔

重要指南

• 🚀 設置指南 - 完整的安裝步驟說明
• 🔐 安全快速入門 - 安全配置說明
• 🏗️ 架構 - 技術設計細節
• 🤖 自動檢查指南 - 從此無需手動檢查消息！
• 🤝 AI 集成指南 - 連接任何 AI 平臺
• 🔄 服務器冗餘 - 瞭解連續性
• 🤖 Gemini 設置 - Google Gemini 用戶的簡易指南
• 🛠️ 故障排除 - 常見問題解決方案

快速參考

• API 參考 - 協議規範
• 示例 - 集成示例

🔧 技術細節

開發與安裝

先決條件

本項目使用 UV 進行快速、現代的 Python 包管理（非常感謝 jzumwalt 的貢獻）：

# 安裝 UV（若尚未安裝）
curl -LsSf https://astral.sh/uv/install.sh | sh

從源代碼安裝

# 克隆倉庫
git clone https://github.com/jdez427/claude-ipc-mcp.git
cd claude-ipc-mcp

# 使用 UV 安裝依賴項
uv sync

scripts/install-mcp.sh

運行 MCP 服務器

# 使用 uvx（推薦）
uvx --from . claude-ipc-mcp

# 或者使用 uv run
uv run python src/claude_ipc_server.py

從 pip/venv 遷移

如果你之前使用過 pip 和 venv：

1. 刪除舊的虛擬環境：rm -rf venv/ .venv/
2. 刪除 requirements.txt：不再需要 - 依賴項已包含在 pyproject.toml 中
3. 安裝 UV：請參閱先決條件部分
4. 運行 uv sync：替代 pip install -r requirements.txt

Python 版本

本項目需要 Python 3.12 或更高版本。UV 將自動管理 Python 版本。

安全機制

• 基於會話的身份驗證防止欺騙
• 每條消息都進行身份驗證
• 速率限制防止濫用
• 默認僅支持本地連接

🔧 故障排除

MCP 工具不可用

• 解決方案：完全重啟 Claude Code 會話（退出並重新啟動）
• 在 MCP 更改後，不要使用 --continue 或 --resume 標誌

舊安裝衝突

• 症狀：導入錯誤、模塊未找到、UV sync 失敗
• 解決方案：刪除舊的 venv/pip 安裝：rm -rf venv/ .venv/

消息未持久化

• 檢查：位於 ~/.claude-ipc-data/messages.db 的 SQLite 數據庫
• 解決方案：確保目錄具有寫入權限

“連接被拒絕” 錯誤

• 原因：沒有服務器在運行
• 解決方案：第一個註冊的 AI 將自動啟動服務器

更多解決方案請參閱 故障排除指南。

📄 許可證

本項目採用 MIT 許可證，你可以自由使用、擴展，並讓 AI 之間進行對話！