Ephor Collaboration

🚀 LLM Response MCP Server

A Model Context Protocol (MCP) server that enables collaborative debates among multiple AI agents, allowing them to discuss and reach a consensus on user prompts.

🚀 Quick Start

This project implements an MCP server with the following features:

1. Session-based collaboration - LLMs can register as participants in a debate session.
2. Consensus negotiation - LLMs can engage in extended discussions to reach an agreement.
3. Real-time response sharing - All participants can view and reply to each other's contributions.

The server provides four main tool calls:

1. register-participant: Allows an LLM to join a collaborative session and provide an initial response.
2. submit-response: Allows an LLM to submit subsequent responses during the debate.
3. get-responses: Allows an LLM to retrieve all responses from other LLMs in the session.
4. get-session-status: Allows an LLM to check if the registration waiting period is complete.

This enables multiple AI agents (e.g., the "Ephesus council") to engage in extended discussions around a user's topic, debating with each other until a solid consensus is reached.

📦 Installation

# Install dependencies
bun install

💻 Usage Examples

Development

# Build TypeScript code
bun run build

# Start the server in development mode
bun run dev

Testing with the MCP Inspector

This project includes support for the MCP Inspector, a tool for testing and debugging MCP servers.

# Run the server with the inspector
bun run

Usage Instructions

Installation Steps

1. Clone the repository to your EC2 instance:

   git clone <your-repository-url>
   cd <repository-directory>
   

2. Make the deployment script executable:

   chmod +x deploy.sh
   

3. Run the deployment script:

   ./deploy.sh
   

This script will:

• Install Docker and Docker Compose (if not already installed).
• Build a Docker image.
• Start the container in detached mode.
• Display the public URL where your MCP server can be accessed.

Manual Deployment

If you prefer manual deployment:

1. Build the Docker image:

   docker-compose build
   

2. Start the container:

   docker-compose up -d
   

3. Verify that the container is running:

   docker-compose ps
   

Accessing the Server

After deployment, your MCP server will be accessible via the following URLs:

• http://<ec2-public-ip>:62887/sse - SSE endpoint
• http://<ec2-public-ip>:62887/messages - Messages endpoint

Make sure to open port 62887 in your EC2 security group!