cib7-mcp

CIB Seven プロセスインスタンスを調査するための MCP ツールです。Claude に CIB Seven REST API の包括的な知識を提供し、ライブ実行と Keycloak 認証を可能にします。

機能

• 7つの調査ツール — プロセスインスタンス、インシデント、アクティビティ履歴、変数、BPMN XML、ジョブ

• セマンティックな説明 — Claude は単なる生のエンドポイントデータではなく、各フィールドが運用上何を意味するかを理解します

• BPMN イントロスペクション — プロセス定義 XML を取得し、Claude が期待される実行パスと実際の実行パスを推論します

• Keycloak 認証 — 自動トークン更新を備えた OIDC クライアント資格情報フロー

• 変数マスキング — 機密データを隠すための設定可能な正規表現パターン

• 診断プロンプト — diagnose_stuck_process および incident_report ワークフロー

インストール

Claude Desktop

claude_desktop_config.json に以下を追加します：

{
  "mcpServers": {
    "cib7": {
      "command": "npx",
      "args": ["cib7-mcp"],
      "env": {
        "CIB7_URL": "http://localhost:6009/rest"
      }
    }
  }
}

Claude Code

claude mcp add cib7-mcp -- npx cib7-mcp

次に、環境変数 CIB7_URL を CIB Seven インスタンスに設定します。

設定

すべての設定は環境変数を通じて行います。

KEYCLOAK_* 変数が設定されている場合、4つすべてを指定する必要があります。何も設定されていない場合、ツールは非認証モードで実行されます。

Keycloak を使用する場合

{
  "mcpServers": {
    "cib7": {
      "command": "npx",
      "args": ["cib7-mcp"],
      "env": {
        "CIB7_URL": "https://your-instance.com/rest",
        "KEYCLOAK_URL": "https://your-keycloak.com",
        "KEYCLOAK_REALM": "your-realm",
        "KEYCLOAK_CLIENT_ID": "mcp-client",
        "KEYCLOAK_CLIENT_SECRET": "your-secret",
        "CIB7_REDACT_PATTERNS": "password.*,secret.*,token.*,creditCard.*"
      }
    }
  }
}

ツール

プロンプト

使用例

Claude への質問例：

• 「プロセス abc-123 はスタックしていますか？」

• 「オープンなインシデントをすべて表示して」

• 「プロセス定義 orderProcess:1:456 の BPMN 定義は何ですか？」

• 「インシデントレポートを生成して」

開発

npm install
npm run build
npm test

Node.js 18 以上が必要です。

ライセンス

MIT