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:

1. Core MCP Server

   • Agent Registry
   • Message Bus
   • Task Coordination
   • Context Sharing

2. GitHub Integration Layer

   • Issue Management
   • PR Workflow
   • Project Management

3. 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

1. Clone the repository:

   git clone https://github.com/mkc909/agent-communication-mcp-server.git
   cd agent-communication-mcp-server
   

2. Install dependencies:

   npm install
   

3. 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
   

4. Build the project:

   npm run build
   

5. 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