Skip to content
Gemini CLI

mainframe mcp server for Gemini CLI

io.github.notharshhaa/mainframe-mcp-server

MCP server for IBM z/OS jobs, datasets, USS, and operational diagnostics via Zowe SDK.

client:Gemini CLI transport:stdio runtime:npm

Install mainframe mcp server in Gemini CLI

~/.gemini/settings.json · windows: %USERPROFILE%\.gemini\settings.json

Held in this page only — never stored, logged, or sent anywhere but back to your screen.

{
  "mcpServers": {
    "mainframe-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@notharshhaa/mainframe-mcp-server"
      ],
      "env": {
        "ZOSMF_HOST": "<ZOSMF_HOST>",
        "ZOSMF_PORT": "<ZOSMF_PORT>",
        "ZOSMF_BASE_PATH": "<ZOSMF_BASE_PATH>",
        "ZOSMF_USER": "<ZOSMF_USER>",
        "ZOSMF_PASSWORD": "<ZOSMF_PASSWORD>",
        "ZOSMF_TOKEN": "<ZOSMF_TOKEN>",
        "ZOSMF_TOKEN_TYPE": "<ZOSMF_TOKEN_TYPE>",
        "ZOSMF_REJECT_UNAUTHORIZED": "<ZOSMF_REJECT_UNAUTHORIZED>",
        "LOG_LEVEL": "<LOG_LEVEL>",
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "MCP_SSE_PORT": "<MCP_SSE_PORT>",
        "MAX_JOB_OUTPUT_LINES": "<MAX_JOB_OUTPUT_LINES>",
        "MAX_DATASET_READ_LINES": "<MAX_DATASET_READ_LINES>",
        "MAX_JES_SPOOL_FILES": "<MAX_JES_SPOOL_FILES>",
        "MAX_AUDIT_LINES": "<MAX_AUDIT_LINES>",
        "CMCI_CONTEXT": "<CMCI_CONTEXT>",
        "CMCI_HOST": "<CMCI_HOST>",
        "CMCI_PORT": "<CMCI_PORT>",
        "CMCI_BASE_PATH": "<CMCI_BASE_PATH>",
        "DB2_LOCATION": "<DB2_LOCATION>",
        "DB2_HOST": "<DB2_HOST>",
        "DB2_PORT": "<DB2_PORT>",
        "DB2_BASE_PATH": "<DB2_BASE_PATH>",
        "SMF_SUMMARY_DATASET": "<SMF_SUMMARY_DATASET>",
        "RMF_METRICS_ENABLED": "<RMF_METRICS_ENABLED>",
        "RACF_AUDIT_USS_PATH": "<RACF_AUDIT_USS_PATH>",
        "RACF_AUDIT_DATASET": "<RACF_AUDIT_DATASET>",
        "SECURITY_READ_ONLY": "<SECURITY_READ_ONLY>",
        "SECURITY_ALLOWED_TOOLS": "<SECURITY_ALLOWED_TOOLS>",
        "SECURITY_BLOCKED_TOOLS": "<SECURITY_BLOCKED_TOOLS>",
        "SECURITY_ALLOWED_DATASET_PATTERNS": "<SECURITY_ALLOWED_DATASET_PATTERNS>",
        "SECURITY_ALLOWED_USS_PATHS": "<SECURITY_ALLOWED_USS_PATHS>",
        "SECURITY_AUDIT_LOGGING": "<SECURITY_AUDIT_LOGGING>",
        "SECURITY_MAX_JCL_BYTES": "<SECURITY_MAX_JCL_BYTES>"
      }
    }
  }
}

Gemini expands $VAR and ${VAR} inside env values, so a secret can live in your shell rather than this file. Gemini CLI docs

mainframe mcp server in other clients