MCP Server
MCP
io.github.NotHarshhaa/mainframe-mcp-server
By MCP server for IBM z/OS jobs, datasets, USS, and operational diagnostics via Zowe SDK.
Install
npx -y @notharshhaa/[email protected]Configuration Example
{
"remotes": [],
"packages": [
{
"registryType": "npm",
"identifier": "@notharshhaa/mainframe-mcp-server",
"version": "2.5.0",
"transport": {
"type": "stdio"
},
"environmentVariables": [
{
"description": "z/OSMF hostname or IP address",
"isRequired": true,
"format": "string",
"name": "ZOSMF_HOST"
},
{
"description": "z/OSMF HTTPS port (default 443)",
"format": "number",
"name": "ZOSMF_PORT"
},
{
"description": "Optional API gateway or mediation layer prefix for z/OSMF",
"format": "string",
"name": "ZOSMF_BASE_PATH"
},
{
"description": "z/OS user id (required with ZOSMF_PASSWORD unless ZOSMF_TOKEN is set)",
"format": "string",
"name": "ZOSMF_USER"
},
{
"description": "Password for basic auth (required with ZOSMF_USER unless ZOSMF_TOKEN is set)",
"format": "string",
"isSecret": true,
"name": "ZOSMF_PASSWORD"
},
{
"description": "Auth token (alternative to user/password)",
"format": "string",
"isSecret": true,
"name": "ZOSMF_TOKEN"
},
{
"description": "Token type when using ZOSMF_TOKEN (e.g. LTPA2)",
"format": "string",
"name": "ZOSMF_TOKEN_TYPE"
},
{
"description": "Verify TLS certificates (true in production)",
"format": "boolean",
"name": "ZOSMF_REJECT_UNAUTHORIZED"
},
{
"description": "Log level: fatal, error, warn, info, debug, trace, silent",
"format": "string",
"name": "LOG_LEVEL"
},
{
"description": "Transport: stdio (IDE) or sse (container/network)",
"format": "string",
"name": "MCP_TRANSPORT"
},
{
"description": "Listen port when MCP_TRANSPORT=sse",
"format": "number",
"name": "MCP_SSE_PORT"
},
{
"description": "Max lines returned from a single spool DD",
"format": "number",
"name": "MAX_JOB_OUTPUT_LINES"
},
{
"description": "Max lines returned from dataset or USS reads",
"format": "number",
"name": "MAX_DATASET_READ_LINES"
},
{
"description": "Max spool files fetched during diagnostics",
"format": "number",
"name": "MAX_JES_SPOOL_FILES"
},
{
"description": "Max RACF audit log lines per query",
"format": "number",
"name": "MAX_AUDIT_LINES"
},
{
"description": "CICSplex name or region APPLID (required for CICS tools)",
"format": "string",
"name": "CMCI_CONTEXT"
},
{
"description": "CMCI hostname (defaults to ZOSMF_HOST)",
"format": "string",
"name": "CMCI_HOST"
},
{
"description": "CMCI HTTPS port (default 1490)",
"format": "number",
"name": "CMCI_PORT"
},
{
"description": "CMCI REST base path",
"format": "string",
"name": "CMCI_BASE_PATH"
},
{
"description": "Db2 subsystem location name (required for Db2 tools)",
"format": "string",
"name": "DB2_LOCATION"
},
{
"description": "Db2 REST hostname (defaults to ZOSMF_HOST)",
"format": "string",
"name": "DB2_HOST"
},
{
"description": "Db2 REST port (default 50400)",
"format": "number",
"name": "DB2_PORT"
},
{
"description": "Db2 REST base path",
"format": "string",
"name": "DB2_BASE_PATH"
},
{
"description": "Optional SMF summary dataset for offline metrics",
"format": "string",
"name": "SMF_SUMMARY_DATASET"
},
{
"description": "Query z/OSMF RMF metrics when available",
"format": "boolean",
"name": "RMF_METRICS_ENABLED"
},
{
"description": "USS path to RACF audit log file",
"format": "string",
"name": "RACF_AUDIT_USS_PATH"
},
{
"description": "Sequential dataset containing RACF audit records",
"format": "string",
"name": "RACF_AUDIT_DATASET"
},
{
"description": "When true, blocks write tools such as submit_jcl",
"format": "boolean",
"name": "SECURITY_READ_ONLY"
},
{
"description": "Comma-separated allowlist of MCP tool names",
"format": "string",
"name": "SECURITY_ALLOWED_TOOLS"
},
{
"description": "Comma-separated blocklist of MCP tool names",
"format": "string",
"name": "SECURITY_BLOCKED_TOOLS"
},
{
"description": "Comma-separated dataset patterns (e.g. USERDEV.*,SYS1.*)",
"format": "string",
"name": "SECURITY_ALLOWED_DATASET_PATTERNS"
},
{
"description": "Comma-separated USS path prefixes",
"format": "string",
"name": "SECURITY_ALLOWED_USS_PATHS"
},
{
"description": "Log every tool invocation to stderr (SIEM-friendly JSON)",
"format": "boolean",
"name": "SECURITY_AUDIT_LOGGING"
},
{
"description": "Maximum inline JCL size for submit_jcl",
"format": "number",
"name": "SECURITY_MAX_JCL_BYTES"
}
]
}
]
}
mcp
model-context-protocol
npm
Comments
Sign in to leave a comment