rabbitmq-mcp

rabbitmq-mcp

RabbitMQ 用の Model Context Protocol（MCP）サーバーです。MCP クライアントが RabbitMQ と連携できるようにします。このサーバーは、公式 RabbitMQ HTTP API で利用できる幅広い機能をツールとして公開することを目指しています。

MCP は、LLM（大規模言語モデル）と RabbitMQ などの外部システム間のコンテキストを管理するための標準化されたプロトコルです。Claude Desktop や Cursor などの MCP 対応 AI エージェントに、自然言語で外部システムと連携するよう依頼できます。

💬 リクエストの例：

• inbound signup metrics キューのメッセージ数を取得し、10,000 を超えていたら、その半分を metrics overflow キューに移動してください。
• outbound email deadletter キューをパージしてください。
• production vhost でアラームが発生しているか確認してください。

これらは、MCP クライアントがこのサーバーを使って解析し、実行できるリクエストです。

インストール

ローカルにインストールする場合：

npm install -g rabbitmq-mcp

または npx を使用する場合：

npx -y rabbitmq-mcp

環境変数

RabbitMQ インスタンスへの接続を設定するには、次の環境変数が必要です。

• RABBITMQ_HOST – アクセス可能なホスト（例：test.abc.cloudamqp.com）
• RABBITMQ_USERNAME – RabbitMQ のユーザー名
• RABBITMQ_PASSWORD – RabbitMQ のパスワード
• RABBITMQ_MANAGEMENT_PORT – 管理ポート（例：443 または 15672）
• RABBITMQ_PROTOCOL – https（デフォルト）または http。安全な接続には https を使用してください。

TLS/HTTPS のオプション設定

TLS/HTTPS の認証情報は、ファイルパスまたは環境変数の文字列として指定できます。

• RABBITMQ_CA – CA 証明書（PEM 文字列）
• RABBITMQ_CERT – クライアント証明書（PEM 文字列）
• RABBITMQ_KEY – クライアント秘密鍵（PEM 文字列）
• RABBITMQ_CA_PATH – CA 証明書ファイルへのパス
• RABBITMQ_CERT_PATH – クライアント証明書ファイルへのパス
• RABBITMQ_KEY_PATH – クライアント秘密鍵ファイルへのパス

必要に応じて、デバッグ用の証明書検証フラグを使用できます。

• RABBITMQ_REJECT_UNAUTHORIZED – false に設定すると、サーバー証明書の検証を無効にします（デフォルトは true）

MCP クライアントの設定例

MPC は急速に開発が進んでいるため、クライアントの設定がうまくいかない場合があります。Claude と Cursor 向けの設定例を以下に示します。

{
  "mcpServers": {
    "rabbitmq-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "rabbitmq-mcp"],
      "env": {
        "RABBITMQ_HOST": "your-host",
        "RABBITMQ_USERNAME": "your-username",
        "RABBITMQ_PASSWORD": "your-password",
        "RABBITMQ_MANAGEMENT_PORT": "15671",
        "RABBITMQ_CA_PATH": "/path/to/rabbit-cert.crt"
      }
    }
  }
}

初期化エラーが発生する場合は、コマンドや引数に絶対パスを使用する必要があるかもしれません。

  "command": "/local/path/to/node",
  "args": ["/local/path/to/rabbitmq-mcp/dist/index.js"],

重要

現在、このサーバーは stdio を使ったローカル実行のみをサポートしています。SSE/ストリーミングを使ったリモート機能は、今後のアップデートで対応予定です。

重要

このサーバーを使用するには、RabbitMQ インスタンスで管理プラグインを有効にする必要があります。AMQP を介して RabbitMQ と直接やり取りする方法は数多くありますが、このプロトコルで利用できる機能は、HTTP API で利用できる機能のごく一部です。

ライセンス

MIT