Broker MCP

by messageaid

210 downloads Not rated yet
GitHub

About

Broker MCP is a MCP server for Message Aid that enables managing message brokers — RabbitMQ, Azure Service Bus, and SQS — through the Model Context Protocol. It allows MCP clients to inspect and control broker resources such as queues, topics, and subscriptions.

Explore

- Supports RabbitMQ, Azure Service Bus, and SQS brokers.
- Resources for listing queues, topics, and subscriptions.
- Tool to purge queues (RabbitMQ only).
- Configurable operation modes: ReadOnly, MessageAllowed, BrokerAllowed.
- STDIO transport; streamable transport planned.
- Built with .NET and the MCP C# SDK.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Broker MCP
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

| Transport | ... |
|------------|-------------------------------------------------------------------------------------------------|
| STDIO | ✅ |
| Streamable | Planned (based on SDK Support) |

{
  "mcpServers": {
    "messageAid": {
      "command": "docker",
      "args": [
        "run", 
        "-i", 
        "--rm", 
        "--env 'BROKER_URL=rabbitmq://guest:guest@localhost:15672/'",
        "docker pull ghcr.io/messageaid/mcp:latest"]
    }
  }
}

Action

Rabbit MQ

| Action | Rabbit MQ | Azure Service Bus | SQS |
|-------------|-----------|-------------------|---------|
| Purge Queue | ✅ | Planned | Planned |

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "broker mcp": {
            "mcp-messageaid": {
                "command": "docker",
                "args": [
                    "run",
                    "-i",
                    "--rm",
                    "\\"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-messageaid": {
        "command": "docker",
        "args": [
            "run",
            "-i",
            "--rm",
            "\\"
        ]
    }
}

This is the Message Aid MCP server. The goal is to support the three main brokers
of Message Aid, RabbitMQ, Azure Service Bus, and SQS.

Resources

| Resource | Rabbit MQ | Azure Service Bus | SQS |
|---------------|-----------|-------------------|---------|
| Queues | ✅ | Planned | Planned |
| Topics | ✅ | Planned | Planned |
| Subscriptions | Planned | Planned | Planned |

A broker is in rabbitmq speak a HOST + VHOST

- Queue: rabbitmq://broker/queues/name
- Topic: rabbitmq://broker/topics/name
- An Exchange in RabbitMQ
- Subscription: rabbitmq://broker/subscription/base64(source, destinationType, destinationName, propertiesKey)
- A Binding in RabbitMQ

- azure://broker/name
- sqs://localhost/vhost/name

Tools

| Action | Rabbit MQ | Azure Service Bus | SQS |
|-------------|-----------|-------------------|---------|
| Purge Queue | ✅ | Planned | Planned |

Usage

| Transport | ... |
|------------|-------------------------------------------------------------------------------------------------|
| STDIO | ✅ |
| Streamable | Planned (based on SDK Support) |

Via Docker

docker run -i --rm \
  --env 'BROKER_URL=rabbitmq://guest:guest@localhost:15672/' \
  ghcr.io/messageaid/mcp

Sample Json Config for Cursor, etc

{
  "mcpServers": {
    "messageAid": {
      "command": "docker",
      "args": [
        "run", 
        "-i", 
        "--rm", 
        "--env 'BROKER_URL=rabbitmq://guest:guest@localhost:15672/'",
        "docker pull ghcr.io/messageaid/mcp:latest"]
    }
  }
}

Configuration

| Env Var | ... |
|------------|----------------------------------------|
| BROKER_URL | The broker to connect to in URL format |
| MCP_MODE | ReadOnly |
| | MessageAllowed |
| | BrokerAllowed |

Building

Built using dotnet and the MCP C# SDK

docker build -t ghcr.io/messageaid/mcp -f Dockerfile .

Licence

This MCP server is licensed under the BSL 1.1 License. For more details,
see the LICENSE file in the project repository.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.