MQ-Sentinel

Name: MQ-Sentinel
Author: pramodreddyboddu

ローカル

github.comクラウド・インフラ02 週間前に更新

リポジトリ公式サイト

MQ-Sentinel について

MQ-Sentinel は、IBM MQ 環境を運用するチーム向けの読み取り専用診断 MCP サーバーです。構造化された診断結果と検証済みの IBM 文書への引用を返し、破壊的操作を防ぎ、MQ由来のテキストをサニタイズします。

主な機能

018種類のMQ診断ツール
0210種類のMQトポロジーに対応
03検証済みIBM文書の引用
04読み取り専用コマンドの強制
05プロンプトインジェクション対策
06OIDC、RBAC、改ざん検知監査

活用シーン

01チャネルの認可・接続エラーの診断
02デッドレターキューのパターン調査
03クラスター、Native HA、RDQMの状態確認
04z/OSキュー共有グループの問題調査

MCP 対応

stdioまたはHTTP経由で、8種類の読み取り専用診断ツールをMCPクライアントに提供します。ツールはIBM文書の引用付きで診断結果を返し、破壊的操作は行いません。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "pramodreddyboddu-mq-sentinel": {
      "command": "uvx",
      "args": [
        "mq-sentinel"
      ],
      "env": {
        "MQS_AUTH_DISABLE_AUTH_FOR_LOCAL_DEV": "<MQS_AUTH_DISABLE_AUTH_FOR_LOCAL_DEV>",
        "MQS_SERVER_ENVIRONMENT": "<MQS_SERVER_ENVIRONMENT>"
      }
    }
  }
}

起動コマンドuvx mq-sentinel

設定が必要な環境変数

MQS_AUTH_DISABLE_AUTH_FOR_LOCAL_DEVシークレットSet true for local demo only. Refused when environment=prod.

MQS_SERVER_ENVIRONMENTdev | staging | prod — used in audit and RBAC.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

pypimq-sentinel0.5.0stdio

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

MQ-Sentinel

AI エージェントが安全に利用できる、本番環境対応の読み取り専用 IBM MQ 診断 MCP サーバー。ハルシネーションは一切ありません。

エンタープライズ環境における現実の重大な課題を解決するため、本格的なサイドプロジェクトとして開発しました。システムエンジニアリング、セキュリティ、オブザーバビリティ、本番環境へのデプロイ、AI エージェント向けの安全なインフラ構築を示す、充実した公開ポートフォリオとなっています。

0.5.0 — IBM MQ の全 10 種類に対応する 8 つの診断ツール。設計上、読み取り専用です。プロンプトインジェクション対策のファイアウォール。OIDC + RBAC。ハッシュチェーン監査。IBM Knowledge Center の引用を検証済み（CI で強制）。HPA とエアギャップ環境向けパッケージを備えた本番用 Helm。

GitHub： https://github.com/pramodreddyboddu/mq-sentinel
ライブデモ： https://mq-sentinel.io
多くの人に知ってもらう： docs/LAUNCH.md

解決した課題

エンタープライズの IBM MQ チームは、次のような問題の診断に何時間も費やしています。

2035 NOT_AUTHORIZED の大量発生
DLQ の急増
Native HA のレプリカ遅延とスプリットブレイン
古いクラスターメンバー
z/OS の謎めいた問題

従来のツールでは、高度な専門知識とログの手作業による調査が必要です。LLM に生の MQ アクセスを与えることは、セキュリティやコンプライアンスを重視するチームにとって許容できません。

MQ-Sentinel は、Claude、Cursor、Grok などのエージェントに安全な MCP インターフェースを提供します。正確で出典付きの診断を返し、ハルシネーションを起こしたり、破壊的なコマンドを実行したりすることはありません。

課題

IBM MQ チーム（銀行、通信事業者、保険会社、政府機関）は、次のような問題への対応に何時間も費やしています。

2035 NOT_AUTHORIZED チャネルの大量発生
DLQ の急増
Native HA のレプリカ遅延／スプリットブレイン
古いクラスターメンバー
z/OS QSG の謎めいた問題

従来のツールでは、深い MQSC の知識とログの検索が必要です。LLM に MQ への直接アクセスを与えることは、セキュリティやコンプライアンスを重視するチームにとって論外です。

MQ-Sentinel はこの課題を解決します。 Claude、Cursor、Grok などに安全な読み取り専用 MCP インターフェースを提供し、型付きの根本原因 + 修正手順 + 検証済みの IBM ドキュメントを返します。内容を捏造せず、破壊的なコマンドも実行しません。

🎬 90 秒で見る

git clone https://github.com/pramodreddyboddu/mq-sentinel.git
cd mq-sentinel
make demo

同梱のフィクスチャサンドボックスを使って、実際の 2035 NOT_AUTHORIZED、INDOUBT チャネル、1247 件のメッセージがある DLQ、Native HA レプリカの切断を MQ-Sentinel が診断する様子をご覧ください。実稼働の IBM MQ は不要です。

共有用に録画するには、make demo-record を実行すると、ブラウザーで再生できる asciinema の録画が作成されます。

簡単なセルフチェック（MQ 不要）：

uv run mq-sentinel doctor
uv run mq-sentinel tools     # list all diagnostics
uv run mq-sentinel info      # overview + security highlights

Claude、Grok、Cursor、Gemini、ChatGPT から利用する

MCP サーバーは 1 つだけで、ベンダーごとのプラグインは不要です。コピーして貼り付けられる設定：docs/mcp-clients.md。

エージェントがサーバーを見つけられる場所に登録しましょう。公式 MCP Registry（server.json）と Smithery（smithery.yaml）に登録できます。ChatGPT にはローカルの stdio ではなく、ホストされた HTTPS エンドポイントが必要です。

アーキテクチャの概要

flowchart TB
    subgraph Client["MCP Client (Claude / Cursor / Grok)"]
        P[Prompt]
    end

    subgraph Sentinel["MQ-Sentinel (read-only)"]
        OIDC[OIDC + RBAC]
        RL[Rate Limiter]
        DISP[Tool Dispatcher]
        ALLOW[MQSC Allowlist]
        CONN[Connector<br/>(pymqi / fixture)]
        RCS[RCS Engine +<br/>KC Registry]
        SAN[Output Sanitizer]
        AUDIT[Hash-chained<br/>Audit Log]
    end

    subgraph MQ["IBM MQ (read-only service account)"]
        QM[Queue Managers]
    end

    P -->|MCP stdio / HTTP| OIDC
    OIDC --> RL --> DISP
    DISP --> ALLOW
    ALLOW --> CONN
    CONN -->|raw output| RCS
    RCS --> SAN
    SAN --> AUDIT
    CONN --> QM
    QM -.->|DISPLAY only| CONN

安全性を設計段階から確保しています。サーバー内に LLM はありません。すべての引用は CI で検証されます。

ポートフォリオプロジェクトとして際立つ理由

これはおもちゃのようなものでも、週末だけのデモでもありません。実際のエンジニアリングの深さを示しています。

システム＋セキュリティエンジニアリング：包括的な脅威モデル、多層的な読み取り専用の強制、プロンプトインジェクションファイアウォール、OIDC+RBAC、改ざん検知可能な監査、強化されたコンテナ、SBOM＋署名済みイメージ。
本番運用：本番環境向けの Helm（HPA、ServiceMonitor、NetworkPolicy）、エアギャップ環境向けパッケージ（RPM/DEB）、導入時から利用できる可観測性。
AI エージェントインフラストラクチャ：Claude、Cursor、Grok などのエージェントが実際に使用できるよう設計された、完全で安全な MCP サーバー（stdio＋HTTP）。
エンタープライズドメインの専門知識：10 種類のトポロジーにわたる IBM MQ の幅広いカバー範囲と、バージョンを考慮した検証済みの引用。
体系的なデリバリー：実際の組織に必要なコンプライアンス成果物を含む、7 フェーズの組織対応計画を完全に実行。

Grok Build（主要なコーディングパートナー）とともに構築しながら、厳格なエンジニアリング基準を維持しました。

全行程と計画：docs/ORG-READINESS-PLAN.md

こちらもご覧ください：VISION.md · CONTRIBUTING.md · DEVELOPMENT.md

その歩み（ポートフォリオストーリー）

エンタープライズ IBM MQ 環境で繰り返し発生する厄介な問題を解決するために MQ-Sentinel を構築し、その取り組み全体を本格的なエンジニアリングおよびポートフォリオプロジェクトとして進めました。

アーキテクチャの設計から実装、ドキュメント、Helm、コンプライアンス成果物、仕上げまで、主要なコーディングパートナーとして Grok Build（xAI）を活用しました。重要な判断はすべて意図的に行いました。読み取り専用を基本とし、古くならない引用、多層防御、本番環境向けのパッケージングを実現しました。

主なマイルストーン：

最初のツールを作成する前に、脅威モデルと多層セキュリティアーキテクチャを設計
CI で IBM Knowledge Center の引用を検証しながら、10 種類の MQ に対応する 8 つの診断ツールを提供
本番環境へのデプロイ（Helm＋HPA＋ServiceMonitor、distroless、エアギャップ環境向け RPM/DEB）
7 フェーズの組織対応計画を完全に実行（上記のリンクを参照）
271 件以上のテスト（セキュリティ上の不正なケースを含む）、厳格な mypy、プラットフォームチーム向けの包括的なドキュメント

これは、深いドメイン知識、設計段階からのセキュリティ、本番運用、そして実際の組織が利用できる成果物のリリースに至るまで、一貫して責任を担ったことを示しています。

**これは私の公開ポートフォリオプロジェクトです。**システムエンジニアリング、セキュリティ、可観測性、AI インフラストラクチャ、そして規律あるデリバリーを実証しています。

高い基準を一貫して保ちながら、Grok Build とともに構築しました。

セキュリティ体制 — 後付けではなく、組み込み済み

常に読み取り専用です。 静的な MQSC 許可リスト（DISPLAY／DIS／PING CHANNELのみ）。破壊的な動詞は、ツール、コネクター、MQ 側のsetmqautという3つのレイヤーで拒否されます。
プロンプトインジェクション対策ファイアウォール。 MQ から取得したすべての文字列をサニタイズ（制御文字、ゼロ幅文字、ANSI、Unicode のタグ文字、ジェイルブレイクマーカー）し、サーバーから出る前に隔離エンベロープで囲みます。
URL 許可リスト＋リアルタイム検証。 応答で引用できるのはwww.ibm.comのみです。それ以外の URL はすべて伏せられます。レジストリ内のすべての引用（20件以上の理由コード、8件の AMQ コード、18件のトピックページ）を CI で毎日取得し、リンク切れがあれば顧客ではなくビルドが失敗します。
改ざん検知可能な監査ログ。 ハッシュチェーン化された JSONL 形式です。mq-sentinel verify-auditで遡及的な編集を検出できます。
OIDC＋RBAC。 プリンシパルはnonprod-read／prod-read／admin-auditの範囲に限定されます。nonprod トークンで prod QM を照会することはできません。
強化されたランタイム。 Distroless イメージ、非 root、読み取り専用 FS、ケイパビリティの削除、seccomp、ネットワーク送信先の許可リストを採用しています。
サプライチェーン。 SBOM、cosign 署名済みイメージ、CI でのpip-audit＋Trivy、すべての PR に対するセキュリティゲートを備えています。

SECURITY.mdとdocs/threat-model.mdをご覧ください。

組織／エンタープライズでの利用に対応していますか？
このプロジェクトは、実際の組織（銀行、政府機関、大企業）での利用を想定して、意図的に構築されています。取り組みの全容をご覧ください。

オーナーのプロダクト原則と長期的な考え方については、VISION.mdをご覧ください。

組織向け対応計画 — エンドツーエンドで実行した7フェーズの計画
本番環境ガイド＋プラットフォームチームのオンボーディング
セキュリティ体制＋SOC2 証跡チェックリスト
RBAC と認証の例（Okta、Entra ID、Keycloak）
HPA、ServiceMonitor、ネットワークポリシー、フリートサポートを備えた本番環境向け Helm
可観測性 — インポート可能な Grafana＋Prometheus アラート

スキルとエンジニアリングの厳密さ（ポートフォリオの主な実績）

このプロジェクトで実証されること：

システムおよびセキュリティエンジニアリング — 完全な脅威モデル、プロンプトインジェクション防御、多層の読み取り専用適用、OIDC＋RBAC、ハッシュチェーン化された監査ログ、Distroless による強化。
可観測性と本番運用 — メトリクス、ダッシュボード、アラート、ランブック、エアギャップ環境向けパッケージ、本番向け Helm 化。
AI エージェントインフラストラクチャ — LLM がリスクなく利用できる、実用的で安全な MCP サーバー（stdio＋HTTP）を構築。
エンタープライズシステム — 10種類のトポロジーにわたる IBM MQ の深い知識と、バージョンを考慮した診断。
ソフトウェア開発の熟練度 — 271件以上のテスト（セキュリティを含む）、厳格な mypy、ruff、CI によるドキュメント検証、SBOM＋cosign 署名。
エンドツーエンドの提供 — アイデアから組織対応の成果物まで、プラットフォームチームが実際に活用できる包括的なドキュメントも含めて提供。

高いエンジニアリング基準を維持しながら、主要なコーディングパートナーとして Grok Build を活用し、反復的に構築しました。

対応する IBM MQ の種類（フェーズ1完了）

スタンドアロン · マルチインスタンス QM · RDQM · ネイティブ HA · ネイティブ HA＋CRR · ユニフォームクラスター · 従来型クラスター · z/OS キュー共有グループ · MQ アプライアンス · コンテナ化。

診断ツール

ツール	対象	デモでの検出内容
`diagnose_failed_channels`	分散チャネル	2035 NOT_AUTHORIZED、2009／2059 接続エラー、INDOUBT、AMQ9202／9208／9503
`analyze_dlq_and_suggest_reprocessing`	DLQ（ヘッダーのみ。本文は決して読み取りません）	理由別にグループ化（2035／2080／2030／2051／2053／2079）、バックアウトループの検出
`check_cluster_health`	従来型クラスター＋Uniform クラスター	部分的なリポジトリー、古い CLUSQMGR、サスペンドされたメンバー、異常なクラスター・チャネル
`diagnose_native_ha_issues`	K8s／OpenShift Native HA	レプリカ状態、クォーラム、ログ再生の遅延、スプリットブレイン、CRR の遅延
`diagnose_rdqm_issues`	オンプレミスの RHEL RDQM	Pacemaker のクォーラム、オフラインノード、DRBD の接続／ディスク、スプリットブレイン
`diagnose_zos_qsg_issues`	z/OS Queue Sharing Group	QSG メンバー、CHIN、ページセット、バッファープール、CF 構造
`diagnose_multi_instance_issues`	従来型 MIQM	アクティブ／スタンバイ状態、デュアルアクティブのスプリット、スタンバイ権限、フェイルオーバーイベント
`full_mq_health_check`	上記すべて（複合）	エグゼクティブサマリー＋優先順位付き検出結果

サポート対象の MQ バージョン

9.2 LTS、9.3、9.4（9.4.4 以降を含む）、z/OS。 バージョンは接続時に自動検出され、KC ドキュメントへのリンクは検出されたバージョンに基づきます。

インストール — 方法を選択してください

シナリオ	コマンド	所要時間
Claude Code プラグイン	`/plugin marketplace add pramodreddyboddu/mq-sentinel` の後に `/plugin install mq-sentinel@mq-sentinel` を実行（詳細）	1 分
個人／スタートアップのノート PC（開発）	`curl -fsSL https://raw.githubusercontent.com/pramodreddyboddu/mq-sentinel/main/scripts/install.sh \| MQS_DEV_MODE=true MQS_DEV_MODE_ACK_INSECURE=yes bash`	5 分
個人／スタートアップ（本番）	同じコマンドを実行し、`MQS_AUTH_OIDC_*` 環境変数をエクスポートします	5 分
中規模組織の Kubernetes	`helm install mq-sentinel oci://ghcr.io/pramodreddyboddu/charts/mq-sentinel --set oidc.issuer=… --set oidc.audience=… --set oidc.jwksUrl=…`	30 分
ローカル K8s の POC（稼働中の MQ なし）	`cd examples/kind && ./install.sh`	5 分
RHEL／Rocky／OEL	`sudo dnf install https://github.com/pramodreddyboddu/mq-sentinel/releases/latest/download/mq-sentinel-0.4.0-1.x86_64.rpm`	5 分
Debian／Ubuntu	`sudo apt install ./mq-sentinel_0.4.0_amd64.deb`	5 分
エアギャップ環境（銀行／政府機関）	RPM を内部でミラーリングし、組織の GPG で署名して、Satellite／Aptly 経由でデプロイします	1 晩

完全なガイド：docs/INSTALL.md。IBM MQ クライアントライブラリーについては、docs/byom.mdを参照してください。

実際のキューマネージャーに接続する

初期状態では、MQ-Sentinel は同梱のデモ QM（DEMO_QM）を提供します。独自の QM を診断するには、MQS_SERVER_INVENTORY_DIR（QM リスト）と MQS_SERVER_SECRETS_DIR（認証情報）を設定し、mq エクストラ（IBM MQ クライアントが必要な pymqi）をインストールしてください。その後、サーバーは表示専用チャネルを介して実際の環境に接続します。最小権限の setmqaut／CHLAUTH 設定については、docs/onboard-new-qm.mdを参照してください。

クイックスタート（開発者／コントリビューター）

make install        # uv sync + editable install
make test           # pytest
make ci             # lint + type + tests + security suite (everything CI runs)
make docker         # build the production container image
make rpm deb        # build RPM + DEB packages (requires `gem install fpm`)

以下も参照してください：

DEVELOPMENT.md — オーナー向けの開発ガイド
docs/usage-with-ai.md — Claude／Cursor／Grok と併用する際の推奨プロンプトとパターン
docs/ORG-READINESS-PLAN.md — 組織で利用可能な状態にするまでの全工程

トランスポート

# stdio (default — for Claude Desktop, Cursor, Claude Code)
uv run mq-sentinel serve

# HTTP (production — OIDC bearer auth, /healthz, /readyz, /metrics)
uv run mq-sentinel serve --transport http --host 0.0.0.0 --port 8080

OIDC 設定、エンドポイントのリファレンス、運用上の注意事項については、docs/http-transport.mdを参照してください。

リポジトリー構成

src/mq_sentinel/
  security/     command allowlist, output sanitizer, rate limiter
  audit/        hash-chained JSONL audit logger
  auth/         OIDC + RBAC
  inventory/    QM registry (pluggable)
  secrets/      pluggable secrets backend (default: filesystem/K8s)
  connectors/   MQ connection layer (pymqi + fixture)
  rcs/          Root Cause Summary engine + KC doc registry
  tools/        MCP tools (populated Phase 1+)
  telemetry/    OpenTelemetry + structured logging
  cli/          control-plane CLI
deploy/
  Dockerfile    distroless, non-root, read-only FS
  helm/         Kubernetes chart (security defaults on)
tests/
  security/     allowlist + injection firewall corpus (non-negotiable)
  unit/

組織導入準備（7 フェーズ計画を実施済み）

このプロジェクトは、実際のプラットフォーム／SRE チームから信頼されるものにするため、組織導入準備プログラム（7 フェーズ）を完全に実施しました。計画と進捗の全容については、以下を参照してください：

docs/ORG-READINESS-PLAN.md
docs/ORG-READINESS.md — 7 フェーズすべてに対応済み（2026-06-22 時点）

現在の状態：プラットフォームチームによる評価の準備が整っています。

技術ロードマップ

フェーズ 1（MCP 診断ツール）は完了しました。今後の技術項目については、CHANGELOG.md をご覧ください。

0.4.0 — RCS の調査結果から ServiceNow / Jira チケットを自動作成します。
0.5.0 — SOC 2 エビデンスパック生成ツール。
過去のテレメトリー、エアギャップ環境の改善など。

安全な修復は意図的に対象外です。MQ-Sentinel は報告のみを行います。

組織向け

MQ-Sentinel は、最初からエンタープライズでの利用を想定して設計されています。

読み取り専用、プロンプトインジェクション耐性、OIDC + RBAC
検証可能な IBM Knowledge Center の引用
本番環境へのデプロイオプション（Kubernetes、RPM/DEB、エアギャップ環境）
完全な監査証跡

こちらからお始めください：

Helm チャートには、本番環境向けの値、HPA、監視、ネットワークポリシーが含まれています。

ライセンス

Markdown 対応

ログインしてコメント

基本情報

作者: pramodreddyboddu
言語: python
バージョン: 0.5.0
トランスポート: stdio
掲載日: 2026年10月9日
最終更新: 2 週間前
公式 Registry: io.github.pramodreddyboddu/mq-sentinel

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

MQ-Sentinel

MQ-Sentinel について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

MQ-Sentinel

解決した課題

課題

🎬 90 秒で見る

Claude、Grok、Cursor、Gemini、ChatGPT から利用する

アーキテクチャの概要

ポートフォリオプロジェクトとして際立つ理由

その歩み（ポートフォリオストーリー）

セキュリティ体制 — 後付けではなく、組み込み済み

スキルとエンジニアリングの厳密さ（ポートフォリオの主な実績）

対応する IBM MQ の種類（フェーズ1完了）

診断ツール

サポート対象の MQ バージョン

インストール — 方法を選択してください

実際のキューマネージャーに接続する

クイックスタート（開発者／コントリビューター）

トランスポート

リポジトリー構成

組織導入準備（7 フェーズ計画を実施済み）

技術ロードマップ

組織向け

ライセンス

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？