zRobot WSAPI MCP Server

MCP server for IBM Z Hardware Management Console (HMC) Web Services API integration with Bob AI.

Features

• list_systems: List all configured HMC systems

• list_partitions: List all partitions on a CPC/system

• get_partition: Get detailed information for a partition

• create_partition: Create a new partition

• update_partition: Update partition properties

• delete_partition: Delete a partition

• start_partition: Start a partition

• stop_partition: Stop a partition

• get_api_version: Get HMC API version information

Repository Structure

zrobot-wsapi-mcp/
├── .gitignore
├── package.json
├── README.md
├── examples/
│   ├── mcp_settings.json.example
│   └── settings.json.example
├── config/
│   └── systems.yaml.example
├── lib/
│   ├── partition_manager.py
│   └── wsapi_client.py
└── src/
    └── server.py

Installation

This repository packages the WSAPI MCP server into a standalone repo similar to jupitr-custom-mcp-server.

Python dependencies

Install the required Python packages in your environment:

pip install mcp requests pyyaml

Configuration

1. Create an MCP folder in your IBM Bob main directory.

2. Create a folder for this repo, for example:

/Users/your-user/Documents/IBM Bob/MCP/zrobot-wsapi-mcp

3. Clone or copy this repository into that folder.

4. Copy config/systems.yaml.example to config/systems.yaml and fill in your HMC details.

The server is configured in two locations that should point to the same src/server.py file.

1. Bob MCP Settings

File: ~/.bob/settings/mcp_settings.json

"zrobot-wsapi-mcp": {
  "command": "python",
  "args": ["/Your IBM Bob Main Directory/MCP/zrobot-wsapi-mcp/src/server.py"],
  "env": {}
}

2. VS Code User Settings

File: ~/Library/Application Support/Code/User/settings.json

"roo-cline.mcpServers": {
  "zrobot-wsapi-mcp": {
    "command": "python",
    "args": ["/Your IBM Bob Main Directory/MCP/zrobot-wsapi-mcp/src/server.py"],
    "env": {}
  }
}

Systems Configuration

Create config/systems.yaml from the example file:

systems:
  a248_dpm:
    addr: "9.56.193.224"
    user: "pemode"
    password: "your_password"
    cpc: "A248"
    description: "CEC A248 DPM via HMC"

Usage

Once configured in Bob, you can use prompts like:

• List all available HMC systems

• List all partitions on a248_dpm

• Show me details for partition bob1 on a248_dpm

• Create a Linux partition named bob2 on a248_dpm with 4096 MB initial memory and 8192 MB maximum memory

• Start partition bob2 on a248_dpm

• Stop partition bob2 on a248_dpm

• What is the API version for a248_dpm?

Notes

• Credentials are stored locally in config/systems.yaml

• HTTPS is used for HMC communication on port 6794

• SSL verification is disabled in the current client for test environments

• The repo intentionally mirrors the lightweight standalone style of jupitr-custom-mcp-server

License

MIT