Cross-System Agent Communication MCP Server
Overview
This MCP server enables communication and coordination between different Roo modes/roles across multiple systems. It creates a "team of agents" architecture where specialized LLM agents can collaborate on tasks, share context, and coordinate work.
Features
- Agent Registry : Register and manage different Roo modes/roles with their capabilities
- Message Bus : Enable asynchronous communication between agents
- Task Coordination : Manage task assignment and progress tracking
- Context Sharing : Facilitate knowledge transfer between agents
- GitHub Integration : Create and track GitHub issues, manage pull requests
- PlanetScale Integration : Store agent data, messages, and tasks in a scalable database
Architecture
The Cross-System Agent Communication MCP Server consists of three main components:
- Core MCP Server
* Agent Registry
* Message Bus
* Task Coordination
* Context Sharing
- GitHub Integration Layer
* Issue Management
* PR Workflow
* Project Management
- PlanetScale Database Layer
* Agent Data Storage
* Message Storage
* Task Database
Getting Started
Prerequisites
- Node.js 18 or higher
- TypeScript 5.3 or higher
- GitHub API access
- PlanetScale database account
Installation
Clone the repository:
git clone https://github.com/mkc909/agent-communication-mcp-server.git
cd agent-communication-mcp-server
Install dependencies:
npm install
Create a .env
file with the following variables:
GITHUB_TOKEN=your_github_token
PLANETSCALE_HOST=your_planetscale_host
PLANETSCALE_USERNAME=your_planetscale_username
PLANETSCALE_PASSWORD=your_planetscale_password
Build the project:
npm run build
Start the server:
npm start
Development
Running in Development Mode
npm run dev
Running Tests
npm test
Linting
npm run lint
API Endpoints
Agent Management
register_agent
: Register a new agent
update_agent
: Update agent information
get_agent
: Get agent information
list_agents
: List all registered agents
Messaging
send_message
: Send message to another agent
get_messages
: Get messages for an agent
mark_message_read
: Mark message as read
delete_message
: Delete a message
Task Management
create_task
: Create a new task
assign_task
: Assign task to an agent
update_task_status
: Update task status
get_task
: Get task details
list_tasks
: List tasks
Context Sharing
create_context
: Create shared context
update_context
: Update shared context
share_context
: Share context with agent
get_context
: Get shared context
list_contexts
: List shared contexts
GitHub Integration
github_create_issue
: Create GitHub issue
github_comment_issue
: Comment on GitHub issue
github_create_pr
: Create GitHub PR
github_review_pr
: Review GitHub PR
License
MIT