agent-communication-mcp-server

agent-communication-mcp-server

4
communicationdeveloper_toolsdatabases

The Cross-System Agent Communication MCP Server facilitates collaboration between agents in different Roo modes or roles across systems. It supports task coordination, context sharing, and integrates with GitHub and PlanetScale, enhancing communication and team synergy.

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