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

# 2 小时内，发送给 "fred" 的消息将自动转发到 "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/

消息未持久化

• 检查：SQLite 数据库位于 ~/.claude-ipc-data/messages.db
• 解决方案：确保目录具有写入权限

"连接被拒绝" 错误

• 原因：没有服务器正在运行
• 解决方案：第一个注册的 AI 将自动启动服务器

更多解决方案请参阅 故障排除指南。

📄 许可证

本项目采用 MIT 许可协议，你可以自由使用、扩展，让 AI 之间畅所欲言！