Mkc909 Agent Communication MCP Server

🚀 Cross-System Agent Communication MCP Server

The MCP server enables communication and coordination between different Roo modes/roles across multiple systems. It creates an "agent team" architecture where professional LLM agents can collaborate on tasks, share context, and coordinate work.

🚀 Quick Start

Dependencies

• Node.js 18 or higher
• TypeScript 5.3 or higher
• GitHub API authorization
• 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

✨ Features

• Agent Registry: Register and manage different Roo modes/roles and 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.

🔧 Technical Details

System Structure

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

Development

Run in Development Mode

npm run dev

Run Tests

npm test

Formatting

npm run lint

💻 Usage Examples

Basic Usage

The following shows how to start the server:

git clone https://github.com/mkc909/agent-communication-mcp-server.git
cd agent-communication-mcp-server
npm install
npm run build
npm start

Advanced Usage

Run the server in development mode:

npm run dev

📚 Documentation

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.

Message Sending

• send_message: Send a message to another agent.
• get_messages: Get an agent's messages.
• mark_message_read: Mark a message as read.
• delete_message: Delete a message.

Task Management

• create_task: Create a new task.
• assign_task: Assign a task to an agent.
• update_task_status: Update the task status.
• get_task: Get task details.
• list_tasks: List all tasks.

Context Sharing

• create_context: Create a shared context.
• update_context: Update a shared context.
• share_context: Share a context with an agent.
• get_context: Get a shared context.
• list_contexts: List all shared contexts.

GitHub Integration

• github_create_issue: Create a GitHub issue.
• github_comment_issue: Comment on a GitHub issue.
• github_create_pr: Create a GitHub PR.
• github_review_pr: Review a GitHub PR.

📄 License

MIT