ibmz

ibmz-mcp-server

[!License: MIT](https://opensource.org/licenses/MIT) [!MCP](https://modelcontextprotocol.io) [!npm](https://www.npmjs.com/package/ibmz-mcp-server)

IBM Z メインフレーム統合用の MCP サーバーです。IBM Key Protect（FIPS 140-2 Level 3）による HSM を活用した鍵管理と、z/OS Connect を介したメインフレームプログラム（CICS、IMS、バッチ）への REST API アクセスを提供します。

ツール（全 12 種類）

Key Protect -- HSM 鍵管理

ツール	説明
key_protect_list_keys	Key Protect の暗号化鍵を一覧表示します
key_protect_create_key	ルート鍵または標準鍵を作成します
key_protect_get_key	鍵の詳細とメタデータを取得します
key_protect_wrap_key	ルート鍵で DEK をラップ（暗号化）します
key_protect_unwrap_key	ラップされた DEK をアンラップ（復号）します
key_protect_rotate_key	ルート鍵をローテーションします
key_protect_delete_key	鍵を削除します（取り消し不可）
key_protect_get_key_policies	ローテーションと二重認証のポリシーを取得します

z/OS Connect -- メインフレーム統合

ツール	説明
zos_connect_list_services	利用可能なメインフレームサービスを一覧表示します
zos_connect_get_service	サービスの詳細と OpenAPI 仕様を取得します
zos_connect_call_service	REST 経由でメインフレームプログラムを呼び出します（JSON から COBOL）
zos_connect_list_apis	アウトバウンド API 設定を一覧表示します
zos_connect_health	z/OS Connect サーバーの稼働状況を確認します

インストール

npm install

設定

{
  "mcpServers": {
    "ibmz": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/ibmz-mcp-server/index.js"],
      "env": {
        "IBM_CLOUD_API_KEY": "your-api-key",
        "KEY_PROTECT_INSTANCE_ID": "your-instance-id",
        "KEY_PROTECT_URL": "https://us-south.kms.cloud.ibm.com"
      }
    }
  }
}

環境変数

変数	説明	必須
IBM_CLOUD_API_KEY	IBM Cloud API キー	はい（Key Protect）
KEY_PROTECT_INSTANCE_ID	Key Protect インスタンス OCID	はい（Key Protect）
KEY_PROTECT_URL	Key Protect エンドポイント	いいえ（デフォルトは us-south）
ZOS_CONNECT_URL	z/OS Connect ベース URL	はい（z/OS Connect）
ZOS_CONNECT_USERNAME	メインフレームのユーザー名	はい（z/OS Connect）
ZOS_CONNECT_PASSWORD	メインフレームのパスワード	はい（z/OS Connect）

主な概念

エンベロープ暗号化

ルート鍵（KEK）は HSM に保存され、ハードウェアの外に出ることはありません。データ暗号化鍵（DEK）はルート鍵でラップされ、暗号文とともに安全に保管されます。

z/OS Connect

JSON ペイロードを COBOL コピーブックに自動的にマッピングする REST API です。これにより、CICS トランザクション、IMS プログラム、バッチジョブにアクセスできます。

依存関係

• @modelcontextprotocol/sdk -- MCP プロトコル SDK
• @ibm-cloud/ibm-key-protect -- Key Protect クライアント
• ibm-cloud-sdk-core -- IBM Cloud 認証

ライセンス

MIT