About Broker MCP
Broker MCP is a Message Aid server for working with RabbitMQ, Azure Service Bus, and SQS. Its documented support currently covers RabbitMQ queues and topics, plus queue purging; other broker operations are planned.
Key features
- 01RabbitMQ queue and topic resources
- 02RabbitMQ queue purging
- 03STDIO transport
- 04Broker URL configuration
Use cases
- 01Inspect RabbitMQ queues and topics
- 02Purge a RabbitMQ queue
- 03Connect through a configured broker URL
MCP support
It exposes broker resources and actions to MCP clients. The README documents RabbitMQ queue and topic access and queue purging; Azure Service Bus and SQS support is planned.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEBroker 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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.