RabbitMQ MCP Server

Overview

The RabbitMQ MCP Server allows AI assistants like Claude to interact with RabbitMQ message brokers. This enables you to publish messages to queues, consume messages, and manage RabbitMQ resources through natural language conversations with your AI assistant.

Installation Options

Option 1: Install via Smithery (Recommended)

The easiest way to install the RabbitMQ MCP Server is through Smithery:

npx -y @smithery/cli install @kenliao94/mcp-server-rabbitmq --client claude

This command automatically configures the MCP server for use with the Claude desktop app.

Option 2: Manual Installation

1. Clone the repository:

   git clone https://github.com/kenliao94/mcp-server-rabbitmq.git
   cd mcp-server-rabbitmq
   

2. Add the following configuration to your Claude desktop configuration file:

   • On macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
   • On Windows: %APPDATA%/Claude/claude_desktop_config.json

   {
       "mcpServers": {
         "rabbitmq": {
           "command": "uv",
           "args": [
               "--directory",
               "/path/to/repo/mcp-server-rabbitmq",
               "run",
               "mcp-server-rabbitmq",
               "--rabbitmq-host",
               "your-rabbitmq-host",
               "--port",
               "5672",
               "--username",
               "your-rabbitmq-username",
               "--password",
               "your-rabbitmq-password",
               "--use-tls",
               "false"
           ]
         }
       }
   }
   

   Replace the placeholder values with your actual RabbitMQ connection details:

   • your-rabbitmq-host: Your RabbitMQ server hostname (e.g., "localhost" or "rabbitmq.example.com")
   • 5672: The port number for RabbitMQ (default is 5672)
   • your-rabbitmq-username: Your RabbitMQ username
   • your-rabbitmq-password: Your RabbitMQ password
   • --use-tls: Set to "true" if using AMQPS (secure connection), otherwise "false"

Usage

Once installed, you can interact with RabbitMQ through natural language conversations with Claude. Here are some example prompts:

• "Publish a message to the 'notifications' queue with the content 'Hello, world!'"
• "Create a new queue called 'tasks'"
• "Consume messages from the 'events' queue"
• "List all available queues in the RabbitMQ server"

The MCP server handles the translation between your natural language requests and the appropriate RabbitMQ API calls.

Troubleshooting

If you encounter issues with the MCP server:

1. Verify your RabbitMQ connection details in the configuration file
2. Ensure RabbitMQ is running and accessible from your machine
3. Check that the user credentials have appropriate permissions
4. Restart the Claude desktop app after making configuration changes

For more advanced debugging, you can use the debugging tools provided in the MCP documentation at https://modelcontextprotocol.io/docs/tools/debugging.

Limitations

• The current implementation focuses on core RabbitMQ operations
• Advanced features like OAuth 2.1 authentication are planned for future releases
• Streaming capabilities will be added when they become generally available in the Python SDK