mcpField
I
ibmz

ibmz

本地服务
github.com/ExpertVagabond安全09 周前更新
代码仓库

关于 ibmz

ibmz 是面向 IBM Z 主机集成的 MCP 服务，供需要管理密钥或访问主机程序的系统使用。它通过 IBM Key Protect 管理 HSM 密钥，并借助 z/OS Connect 调用 CICS、IMS 和批处理程序。

主要功能

  1. 01列出、创建和查询密钥
  2. 02封装、解封及轮换密钥
  3. 03读取密钥策略
  4. 04列出 z/OS Connect 服务与 API
  5. 05通过 REST 调用主机程序
  6. 06检查 z/OS Connect 健康状态

适用场景

  1. 01管理 IBM Key Protect 加密密钥
  2. 02轮换根密钥并检查策略
  3. 03查看可用主机服务及 OpenAPI 规范
  4. 04通过 JSON 请求调用主机程序

MCP 相关

作为 MCP 服务，它向客户端提供 IBM Key Protect 密钥管理和 z/OS Connect 主机集成工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "expertvagabond-ibmz": {
      "command": "npx",
      "args": [
        "-y",
        "ibmz-mcp-server"
      ]
    }
  }
}
启动命令npx -y ibmz-mcp-server

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmibmz-mcp-server1.0.1

工具

13

收录的工具列表 · 更新于 2 周前

参数类型必填说明
limitnumber否要返回的密钥数量上限（默认值：100）
statearray否按密钥状态筛选：1=Active、2=Suspended、3=Deactivated、5=Destroyed
offsetnumber否分页时要跳过的密钥数量

详细介绍

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 提供由 HSM 支持的密钥管理（FIPS 140-2 Level 3），并通过 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_KEYIBM Cloud API 密钥是（Key Protect）
KEY_PROTECT_INSTANCE_IDKey Protect 实例 OCID是（Key Protect）
KEY_PROTECT_URLKey Protect 端点否（默认为 us-south）
ZOS_CONNECT_URLz/OS Connect 基础 URL是（z/OS Connect）
ZOS_CONNECT_USERNAME大型机用户名是（z/OS Connect）
ZOS_CONNECT_PASSWORD大型机密码是（z/OS Connect）

核心概念

信封加密

根密钥（KEK）存储在 HSM 中，永远不会离开硬件。数据加密密钥（DEK）由根密钥包装，以便与密文一起安全存储。

z/OS Connect

REST API 会自动将 JSON 负载映射到 COBOL 复本，从而支持访问 CICS 事务、IMS 程序和批处理作业。

依赖项

  • @modelcontextprotocol/sdk -- MCP 协议 SDK
  • @ibm-cloud/ibm-key-protect -- Key Protect 客户端
  • ibm-cloud-sdk-core -- IBM Cloud 身份验证

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。