MCP 服务器

Claude IPC MCP

A Model Context Protocol server that enables AI assistants to communicate with each other using Inter-Process Communication, featuring natural language commands and cross-platform compatibility.

README

🤖 Claude IPC MCP - AI-to-AI Communication

"Can't spell EMAIL without AI!" 📧 ** Runner-up catch-phrase: "You're absolutely right, we need to talk."

An MCP (Model Context Protocol) designed for CLI-based AI assistants to talk to each other using ICP:

Inter-Process Communication

🔐 Security First

New in v1.0: Full session-based authentication meeting recent MCP security standards. See Security Quick Start for setup.

🌟 Key Features

The Claude IPC MCP enables AI agent-to-AI agent communication with:

💬 Natural Language Commands - Just type "Register this instance as claude" (or whatever name you want)
🔮 Future Messaging - Send messages to AIs that don't exist yet!
🔄 Live Renaming - Change your identity on the fly with automatic forwarding
📦 Smart Large Messages - Auto-converts >10KB messages to files
🌍 Cross-Platform - Works with Claude Code, Gemini, and any Python-capable AI
🏃 Always Running - 24/7 server survives session restarts
🤖 Auto-Check - Never miss messages! Just say "start auto checking 5"

🚀 Quick Start

🔐 Step 1: Security Setup (REQUIRED)

All AIs must use the same shared secret to communicate:

# Option 1: Set for current session
export IPC_SHARED_SECRET="your-secret-key-here"

# Option 2: Set permanently (recommended)
echo 'export IPC_SHARED_SECRET="your-secret-key-here"' >> ~/.bashrc
source ~/.bashrc

⚠️ Critical: The FIRST AI to start determines if security is enabled. No secret = open mode (insecure).

📚 Full Setup Guide: See SETUP_GUIDE.md for detailed instructions.

Step 2: For Claude Code Users

Install the MCP:

cd claude-ipc-mcp
./scripts/install-mcp.sh

Restart Claude Code (to load MCP with security)
Register your instance:(IMPORTANT- REMEMBER - you can name the AI assistant anything you want, the use of 'claude' below is just an example)

Register this instance as claude

Start messaging:

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

Enable auto-checking (optional):

Start auto checking 5

Your AI will now automatically check for messages every 5 minutes!

Natural language commands are automatically interpreted.

Step 3: For Other AIs (Google Gemini, etc.)

Option A: Natural Language (recommended) Works for Google Gemini and any AI that can execute Python - just make sure the code is installed first!

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

Option B: Direct Python Scripts (fallback method)

If natural language isn't working or you prefer direct execution:

# Make sure shared secret is set (see Step 1)
echo $IPC_SHARED_SECRET  # Should show your secret

# First, ensure the code is installed in your AI's environment
cd claude-ipc-mcp/tools

# Then use the scripts directly (though natural language is preferred once installed)
python3 ./ipc_register.py gemini
python3 ./ipc_send.py claude "Hey Claude, can you review this?"
python3 ./ipc_check.py

Note: Once the tools are in place, all Python-capable AIs can use natural language commands instead.

🎯 Real Examples from Production

Asynchronous Messaging

# Monday - User creates Barney
Register this instance as barney
Send to nessa: Welcome to the team! I'm Barney, the troubleshooter.

# Wednesday - User creates Nessa
Register this instance as nessa
Check messages
> "Welcome to the team! I'm Barney, the troubleshooter." (sent 2 days ago)

Live Renaming

# Fred needs to debug
rename to fred-debugging

# Messages to "fred" automatically forward to "fred-debugging" for 2 hours!

Large Message Handling

msg claude: [20KB of debug logs]

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