使用说明
ibmz mcp服务器
[!许可证：麻省理工学院](https://opensource.org/licenses/MIT) [!主控程序](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个）
密钥保护——HSM密钥管理
| 工具 | 说明 |
|---|---|
key_protect_list_keys |
在密钥保护中列出加密密钥 |
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_INSTANCE_ID |
密钥保护实例OCID | 是（密钥保护） |
KEY_PROTECT_URL |
密钥保护端点 | 否（默认为我们南方） |
ZOS_CONNECT_URL |
z/OS连接基本URL | 是（z/OS连接） |
ZOS_CONNECT_USERNAME |
大型机用户名 | 是（z/OS Connect） |
ZOS_CONNECT_PASSWORD |
大型机密码 | 是（z/OS Connect） |
关键概念
信封加密
根密钥（KEK）存储在HSM中，永远不会离开硬件。数据加密密钥（DEK）由根密钥包裹，与密文一起安全存储。
z/OS连接
REST API自动将JSON有效负载映射到COBOL副本，从而能够访问CICS事务、IMS程序和批处理作业。
依赖项
@modelcontextprotocol/sdk--MCP协议SDK@ibm-cloud/ibm-key-protect--密钥保护客户端ibm-cloud-sdk-core--IBM云身份验证
