Broker MCP

by messageaid

210 downloads
Not rated
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.

Details

Author
messageaid
Downloads
210
Categories
Other

- 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

Run the server via Docker, setting the BROKER_URL environment variable to the target broker URL (e.g., rabbitmq://guest:guest@localhost:15672/). The server communicates over STDIO and can be configured in MCP clients like Cursor using a JSON configuration.

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",
            "\\"
        ]
    }
}

Broker MCP

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.