Society ElizaOS Connector MCP

The Society ElizaOS Connector MCP (Model Context Protocol) allows you to seamlessly integrate your ElizaOS agents with Cursor. This enables you to list available agents, select a specific agent to interact with, and chat directly with your ElizaOS agents from within the Cursor IDE.

This MCP server runs locally on your machine and is managed by Cursor using the stdio transport, meaning Cursor automatically starts and communicates with it.

Features

• List Agents: Retrieve a list of available agents from your ElizaOS instance.
• Select Agent: Choose a specific agent to interact with. The Room ID will be automatically set to match the Agent ID.
• Chat with Agent: Send messages to the selected ElizaOS agent and receive responses.
• Check Status: Verify the MCP server’s connection state and current agent configuration.

Prerequisites

• Node.js and npm (v14 or higher).
• An ElizaOS server instance running and accessible (e.g., locally on http://localhost:3000).
• Cursor IDE with MCP support.

Installation & Usage with Cursor

Quick Setup (Recommended)

The easiest way to use this MCP is directly with Cursor using npx. Cursor will automatically handle running the package.

1. Configure Cursor: Create or open the .cursor/mcp.json file in your project folder (or the global ~/.cursor/mcp.json file) and add:

{
  "mcpServers": {
    "society-elizaos-mcp-npx": { 
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "ELIZAOS_SERVER_URL": "http://localhost:3000",
        "ELIZAOS_USER_ID": "000000000000000000000000000000000000",  example ad64a76a-0e09-0899-b8f8-492d6aea4118
        "ELIZAOS_WORLD_ID": "000000000000000000000000000000000000", example c930b151-dcfb-41c5-96af-550ffea7023c
        "ELIZAOS_AGENT_ID": "000000000000000000000000000000000000", example 85e9fa66-6f8c-0f18-922c-d6c962e21e18
        "ELIZAOS_ROOM_ID": "000000000000000000000000000000000000",  Need to be equal to the ELIZAOS_AGENT_ID 
        "ELIZAOS_CONNECTION_TIMEOUT": "120000",
        "ELIZAOS_RESPONSE_TIMEOUT": "90000",
        "PORT": "3099",
        "DEBUG": "true",
        "NODE_ENV": "production",
        "MCP_DISABLE_PINGS": "true"
      }
  }
}

2. Replace all placeholder UUIDs with your actual ElizaOS IDs.

3. Restart Cursor to apply the configuration changes.

4. Start using the tools in the Cursor interface - they’ll appear as:

   • get_status
   • list_agents
   • chat_with_agent
   • set_agent

Local Development Setup

If you want to run a local development version of the connector, follow these steps:

1. Clone and install dependencies:

   git clone https://github.com/your-username/society-elizaos-mcp.git
   cd society-elizaos-mcp
   npm install
   

2. Build the package:

   npm run build