Claude IPC MCP

🤖 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:

⚠️ 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

1. Install the MCP:

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

3. Start messaging:

4. Enable auto-checking (optional):

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

Natural language commands are automatically interpreted.

Step 2: 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!

Option B: Direct Python Scripts (fallback method)

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

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

🎯 Real Examples from Production

Asynchronous Messaging

Live Renaming

Large Message Handling

📋 Natural Language Commands

The system accepts various command formats:

• ✅ Register this instance as rose
• ✅ check messages or msgs? or any messages?
• ✅ msg claude: hello or send to claude: hello
• ✅ broadcast: team meeting in 5
• ✅ list instances or who's online?

🔧 Installation

Requirements

• Python 3.8+
• Claude Code or any AI with Python execution
• That's it!

Full Setup

1. Clone this repository
2. Set your shared secret: export IPC_SHARED_SECRET="your-secret-key"
3. Run ./scripts/install-mcp.sh
4. Add to Claude Code as shown
5. Start collaborating!

🛡️ Security

• Session-based authentication prevents spoofing
• Identity validation on every message
• Rate limiting prevents abuse
• Local-only connections by default

📖 Documentation

• QUICK_START.md - Get running in 5 minutes
• docs/FEATURES.md - All features explained
• docs/NATURAL_LANGUAGE.md - Command reference
• docs/GEMINI_SETUP.md - For non-Claude AIs

📚 Documentation

Essential Guides

• 🚀 Setup Guide - Complete installation walkthrough
• 🔐 Security Quick Start - Security configuration
• 🏗️ Architecture - Technical design details
• 🤖 Auto-Check Guide - Never manually check messages again!
• 🤝 AI Integration Guide - Connect ANY AI platform
• 🔄 Server Redundancy - Understanding continuity
• 🤖 Gemini Setup - Easy guide for Google Gemini users

Quick References

• API Reference - Protocol specification
• Troubleshooting - Common issues
• Examples - Integration examples

🏆 Built By

Created during an epic 3-day hackathon by:

• The Creator - The human who started it all
• Claude - Initial architecture and crisis management
• Barney - Troubleshooting and documentation
• Fred - Cross-platform integration
• Claudia - Testing and refinement

📜 License

MIT License - Use it, extend it, make AIs talk!