collab-mcp

Multi-AI collaboration MCP server - core communication layer.

Features

• 📨 Message passing between AI agents
• 🔍 Code review request/approval workflow
• 📋 Shared todo list
• 📢 Broadcast messages to all agents
• 📦 Git commit sync
• 🎯 Agent target management
• 🌐 Web UI dashboard
• 🔌 MCP JSON-RPC 2.0 protocol
• 📡 REST API

Quick Start

# Install dependencies
npm install

# Start the server
npm start

# Run tests
npm test

Configuration

All config via environment variables:

| Variable | Default | Description | |---|---|---| | COLLAB_PORT | 3010 | HTTP/MCP port | | COLLAB_DB | ./collab.db | SQLite database path | | COLLAB_PROJECT_ROOT | (none) | Project root for git sync | | COLLAB_HOST | 0.0.0.0 | Listen host |

Usage

MCP JSON-RPC (POST /)

curl -X POST http://127.0.0.1:3010/ \
  -H "Content-Type: application/json" \
  -d '{"method":"send_message","params":{"from_user":"alice","to_user":"bob","content":"hello"},"id":1}'

REST API

# Get messages
curl http://127.0.0.1:3010/api/messages?limit=10

# Send broadcast
curl -X POST http://127.0.0.1:3010/api/broadcast \
  -H "Content-Type: application/json" \
  -d '{"content":"Hello everyone","from_user":"xiaomu"}'

# Ack messages
curl -X POST http://127.0.0.1:3010/api/ack \
  -H "Content-Type: application/json" \
  -d '{"ids":[1,2,3]}'

Web UI

Open http://127.0.0.1:3010/ in your browser.

Architecture

collab-mcp/
├── src/
│   ├── index.js      # Entry point
│   ├── config.js      # Configuration
│   ├── database.js    # SQLite layer (CollabDB class)
│   ├── tools.js       # MCP tool definitions
│   ├── server.js      # HTTP server + JSON-RPC handler
│   ├── routes.js      # REST API routes
│   └── web-ui.js      # Web UI HTML generation
├── test/
│   ├── database.test.js
│   └── tools.test.js
├── docs/
│   └── API.md
└── package.json

License

MIT