Mainframe MCP Server
What it does
MCP server for IBM z/OS jobs, datasets, USS, and operational diagnostics via Zowe SDK.
- Connects パソコンで動く
- Account or key Needs ZOSMF_PASSWORD, ZOSMF_TOKEN, ZOSMF_TOKEN_TYPE, ZOSMF_CERT_KEY · 4 settings to fill in (ZOSMF_HOST, ZOSMF_USER, CMCI_CONTEXT, DB2_LOCATION)
- Category データベース・データセット
インストール
使っているAIアプリを選んで、設定をコピーしてください。
チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげますが、先に準備が必要です
Mainframe MCP Server のキーが必要です(提供元のサイトで作成) · 設定を 4 項目入力 (ZOSMF_HOST, ZOSMF_USER, CMCI_CONTEXT, DB2_LOCATION) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
Mainframe MCP Server に登録してキーを作る
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
設定を 4 項目入力
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
ZOSMF_HOSTz/OSMF hostname or IP addressZOSMF_USERz/OS user id (required with ZOSMF_PASSWORD unless ZOSMF_TOKEN is set)CMCI_CONTEXTCICSplex name or region APPLID (required for CICS tools)DB2_LOCATIONDb2 subsystem location name (required for Db2 tools)
説明は英語の原文のままです。
パソコン版 Claude アプリの設定ファイルを開く
SettingsDeveloperEdit Config
この設定を貼り付けて保存
{ "mcpServers": { "mainframe": { "command": "npx", "args": [ "-y", "@notharshhaa/mainframe-mcp-server" ], "env": { "ZOSMF_HOST": "your-value", "ZOSMF_USER": "your-value", "ZOSMF_PASSWORD": "your-value", "ZOSMF_TOKEN": "your-value", "ZOSMF_TOKEN_TYPE": "your-value", "ZOSMF_CERT_KEY": "your-value", "CMCI_CONTEXT": "your-value", "DB2_LOCATION": "your-value" } } } }キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Claude を終了してもう一度開く
試してみる
Mainframe MCP Server を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が Mainframe MCP Server を使っていると言うか、回答に Mainframe MCP Server のツール名が出れば接続成功です
追加の設定 42 項目(入力しなくても使えます)
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
ZOSMF_PORTz/OSMF HTTPS port (default 443)ZOSMF_BASE_PATHOptional API gateway or mediation layer prefix for z/OSMFZOSMF_REJECT_UNAUTHORIZEDVerify TLS certificates (true in production)ZOSMF_CERTPEM client certificate file path for mTLS authZOSMF_TOKEN_FILERead ZOSMF_TOKEN from this file at startup (vault/agent injection)ZOSMF_USER_IDEnd-user id for PassTicket identity propagation (RACF sees this user, not the service account)ZOSMF_PASSTICKET_APPRACF PTKTDATA application name for PassTicket generation (default ZOSMF)ZOWE_TEAM_CONFIGPath to a zowe.config.json to import connection settings from (env vars win)ZOSMF_PROFILEProfile name inside the Zowe team config (defaults to defaults.zosmf)LOG_LEVELLog level: fatal, error, warn, info, debug, trace, silentMCP_TRANSPORTTransport: stdio (IDE) or sse (legacy HTTP+SSE for container/network deployments)MCP_SSE_PORTListen port when MCP_TRANSPORT=sseMAX_JOB_OUTPUT_LINESMax lines returned from a single spool DDMAX_DATASET_READ_LINESMax lines returned from dataset or USS readsMAX_JES_SPOOL_FILESMax spool files fetched during diagnosticsMAX_AUDIT_LINESMax RACF audit log lines per queryCMCI_HOSTCMCI hostname (defaults to ZOSMF_HOST)CMCI_PORTCMCI HTTPS port (default 1490)CMCI_BASE_PATHCMCI REST base pathDB2_HOSTDb2 REST hostname (defaults to ZOSMF_HOST)DB2_PORTDb2 REST port (default 50400)DB2_BASE_PATHDb2 REST base pathSMF_SUMMARY_DATASETOptional SMF summary dataset for offline metricsRMF_METRICS_ENABLEDQuery z/OSMF RMF metrics when availableRACF_AUDIT_USS_PATHUSS path to RACF audit log fileRACF_AUDIT_DATASETSequential dataset containing RACF audit recordsSECURITY_READ_ONLYWhen true (default), blocks write tools such as submit_jclSECURITY_ALLOWED_TOOLSComma-separated allowlist of MCP tool namesSECURITY_BLOCKED_TOOLSComma-separated blocklist of MCP tool namesSECURITY_ALLOWED_DATASET_PATTERNSComma-separated dataset patterns (e.g. USERDEV.*,SYS1.*)SECURITY_ALLOWED_USS_PATHSComma-separated USS path prefixesSECURITY_AUDIT_LOGGINGLog every tool invocation to stderr (SIEM-friendly JSON)SECURITY_MAX_JCL_BYTESMaximum inline JCL size for submit_jclSECURITY_WRITE_APPROVALHuman-in-the-loop: submit_jcl returns a one-time token and approve_write executes (default false)SECURITY_JCL_SCANPre-flight scan JCL before submission: IDCAMS DELETE, IEFBR14 DISP DELETE, blocked utilities (default true)SECURITY_JCL_SCAN_STRICTStrict scan mode: WARN findings also block submissions (default false)SECURITY_BLOCKED_PROGRAMSComma-separated EXEC programs that may never run (extends ADRDSSU,ICKDSF,IEHINITT)SECURITY_BLOCKED_JOB_CLASSESComma-separated JES job classes that may never be usedSECURITY_CHANGE_TICKET_PATTERNRegex a changeTicket argument must match on writes, e.g. CHG[0-9]{6}SECURITY_WRITE_WINDOWAllowed write window, 24h HH:MM-HH:MM (overnight ranges allowed), e.g. 08:00-18:00SECURITY_WRITE_DAYSWeekdays writes are allowed: 0=Sun..6=Sat, e.g. 1-5SECURITY_WRITE_WINDOW_TZIANA timezone for the write window (default UTC)
説明は英語の原文のままです。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT はまだ Mainframe MCP Server につなげません
Mainframe MCP Server はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません
代わりにできること
A · Mainframe MCP Server につなげるアプリを使う
- Mainframe MCP Server のキーが必要です(提供元のサイトで作成) · 設定を 4 項目入力 (ZOSMF_HOST, ZOSMF_USER, CMCI_CONTEXT, DB2_LOCATION) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
- Mainframe MCP Server のキーが必要です(提供元のサイトで作成) · 設定を 4 項目入力 (ZOSMF_HOST, ZOSMF_USER, CMCI_CONTEXT, DB2_LOCATION) · 先にパソコンへ Node.js を入れてください(1 回だけ)
- Mainframe MCP Server のキーが必要です(提供元のサイトで作成) · 設定を 4 項目入力 (ZOSMF_HOST, ZOSMF_USER, CMCI_CONTEXT, DB2_LOCATION) · 先にパソコンへ Node.js を入れてください(1 回だけ)
- Mainframe MCP Server のキーが必要です(提供元のサイトで作成) · 設定を 4 項目入力 (ZOSMF_HOST, ZOSMF_USER, CMCI_CONTEXT, DB2_LOCATION) · 先にパソコンへ Node.js を入れてください(1 回だけ)
B · データベース・データセット の中で ChatGPT につなげる別のサーバー
同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました
- Supabase✓ ChatGPT
- Appwrite MCP✓ ChatGPT
- Pg Aiguide✓ ChatGPT
Claude Code につなげますが、先に準備が必要です
Mainframe MCP Server のキーが必要です(提供元のサイトで作成) · 設定を 4 項目入力 (ZOSMF_HOST, ZOSMF_USER, CMCI_CONTEXT, DB2_LOCATION) · 先にパソコンへ Node.js を入れてください(1 回だけ)
Mainframe MCP Server に登録してキーを作る
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
設定を 4 項目入力
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
ZOSMF_HOSTz/OSMF hostname or IP addressZOSMF_USERz/OS user id (required with ZOSMF_PASSWORD unless ZOSMF_TOKEN is set)CMCI_CONTEXTCICSplex name or region APPLID (required for CICS tools)DB2_LOCATIONDb2 subsystem location name (required for Db2 tools)
説明は英語の原文のままです。
ターミナルを開く
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
このコマンドを貼り付けて Enter
claude mcp add --scope user mainframe --env ZOSMF_HOST=your-value --env ZOSMF_USER=your-value --env ZOSMF_PASSWORD=your-value --env ZOSMF_TOKEN=your-value --env ZOSMF_TOKEN_TYPE=your-value --env ZOSMF_CERT_KEY=your-value --env CMCI_CONTEXT=your-value --env DB2_LOCATION=your-value -- npx -y @notharshhaa/mainframe-mcp-serverEnter の前に「your-value」を自分のキーに書き換えてください
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Claude Code で /mcp と入力
Mainframe MCP Server が一覧にあり、接続済みと表示されれば OK です
試してみる
Mainframe MCP Server を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が Mainframe MCP Server を使っていると言うか、回答に Mainframe MCP Server のツール名が出れば接続成功です
追加の設定 42 項目(入力しなくても使えます)
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
ZOSMF_PORTz/OSMF HTTPS port (default 443)ZOSMF_BASE_PATHOptional API gateway or mediation layer prefix for z/OSMFZOSMF_REJECT_UNAUTHORIZEDVerify TLS certificates (true in production)ZOSMF_CERTPEM client certificate file path for mTLS authZOSMF_TOKEN_FILERead ZOSMF_TOKEN from this file at startup (vault/agent injection)ZOSMF_USER_IDEnd-user id for PassTicket identity propagation (RACF sees this user, not the service account)ZOSMF_PASSTICKET_APPRACF PTKTDATA application name for PassTicket generation (default ZOSMF)ZOWE_TEAM_CONFIGPath to a zowe.config.json to import connection settings from (env vars win)ZOSMF_PROFILEProfile name inside the Zowe team config (defaults to defaults.zosmf)LOG_LEVELLog level: fatal, error, warn, info, debug, trace, silentMCP_TRANSPORTTransport: stdio (IDE) or sse (legacy HTTP+SSE for container/network deployments)MCP_SSE_PORTListen port when MCP_TRANSPORT=sseMAX_JOB_OUTPUT_LINESMax lines returned from a single spool DDMAX_DATASET_READ_LINESMax lines returned from dataset or USS readsMAX_JES_SPOOL_FILESMax spool files fetched during diagnosticsMAX_AUDIT_LINESMax RACF audit log lines per queryCMCI_HOSTCMCI hostname (defaults to ZOSMF_HOST)CMCI_PORTCMCI HTTPS port (default 1490)CMCI_BASE_PATHCMCI REST base pathDB2_HOSTDb2 REST hostname (defaults to ZOSMF_HOST)DB2_PORTDb2 REST port (default 50400)DB2_BASE_PATHDb2 REST base pathSMF_SUMMARY_DATASETOptional SMF summary dataset for offline metricsRMF_METRICS_ENABLEDQuery z/OSMF RMF metrics when availableRACF_AUDIT_USS_PATHUSS path to RACF audit log fileRACF_AUDIT_DATASETSequential dataset containing RACF audit recordsSECURITY_READ_ONLYWhen true (default), blocks write tools such as submit_jclSECURITY_ALLOWED_TOOLSComma-separated allowlist of MCP tool namesSECURITY_BLOCKED_TOOLSComma-separated blocklist of MCP tool namesSECURITY_ALLOWED_DATASET_PATTERNSComma-separated dataset patterns (e.g. USERDEV.*,SYS1.*)SECURITY_ALLOWED_USS_PATHSComma-separated USS path prefixesSECURITY_AUDIT_LOGGINGLog every tool invocation to stderr (SIEM-friendly JSON)SECURITY_MAX_JCL_BYTESMaximum inline JCL size for submit_jclSECURITY_WRITE_APPROVALHuman-in-the-loop: submit_jcl returns a one-time token and approve_write executes (default false)SECURITY_JCL_SCANPre-flight scan JCL before submission: IDCAMS DELETE, IEFBR14 DISP DELETE, blocked utilities (default true)SECURITY_JCL_SCAN_STRICTStrict scan mode: WARN findings also block submissions (default false)SECURITY_BLOCKED_PROGRAMSComma-separated EXEC programs that may never run (extends ADRDSSU,ICKDSF,IEHINITT)SECURITY_BLOCKED_JOB_CLASSESComma-separated JES job classes that may never be usedSECURITY_CHANGE_TICKET_PATTERNRegex a changeTicket argument must match on writes, e.g. CHG[0-9]{6}SECURITY_WRITE_WINDOWAllowed write window, 24h HH:MM-HH:MM (overnight ranges allowed), e.g. 08:00-18:00SECURITY_WRITE_DAYSWeekdays writes are allowed: 0=Sun..6=Sat, e.g. 1-5SECURITY_WRITE_WINDOW_TZIANA timezone for the write window (default UTC)
説明は英語の原文のままです。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげますが、先に準備が必要です
Mainframe MCP Server のキーが必要です(提供元のサイトで作成) · 設定を 4 項目入力 (ZOSMF_HOST, ZOSMF_USER, CMCI_CONTEXT, DB2_LOCATION) · 先にパソコンへ Node.js を入れてください(1 回だけ)
Mainframe MCP Server に登録してキーを作る
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
設定を 4 項目入力
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
ZOSMF_HOSTz/OSMF hostname or IP addressZOSMF_USERz/OS user id (required with ZOSMF_PASSWORD unless ZOSMF_TOKEN is set)CMCI_CONTEXTCICSplex name or region APPLID (required for CICS tools)DB2_LOCATIONDb2 subsystem location name (required for Db2 tools)
説明は英語の原文のままです。
キーを入力
Mainframe MCP Server の設定で ZOSMF_PASSWORD, ZOSMF_TOKEN, ZOSMF_TOKEN_TYPE, ZOSMF_CERT_KEY, ZOSMF_HOST, ZOSMF_USER, CMCI_CONTEXT, DB2_LOCATION が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Cursor の AI チャットを Agent モードで開く
試してみる
Mainframe MCP Server を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が Mainframe MCP Server を使っていると言うか、回答に Mainframe MCP Server のツール名が出れば接続成功です
追加の設定 42 項目(入力しなくても使えます)
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
ZOSMF_PORTz/OSMF HTTPS port (default 443)ZOSMF_BASE_PATHOptional API gateway or mediation layer prefix for z/OSMFZOSMF_REJECT_UNAUTHORIZEDVerify TLS certificates (true in production)ZOSMF_CERTPEM client certificate file path for mTLS authZOSMF_TOKEN_FILERead ZOSMF_TOKEN from this file at startup (vault/agent injection)ZOSMF_USER_IDEnd-user id for PassTicket identity propagation (RACF sees this user, not the service account)ZOSMF_PASSTICKET_APPRACF PTKTDATA application name for PassTicket generation (default ZOSMF)ZOWE_TEAM_CONFIGPath to a zowe.config.json to import connection settings from (env vars win)ZOSMF_PROFILEProfile name inside the Zowe team config (defaults to defaults.zosmf)LOG_LEVELLog level: fatal, error, warn, info, debug, trace, silentMCP_TRANSPORTTransport: stdio (IDE) or sse (legacy HTTP+SSE for container/network deployments)MCP_SSE_PORTListen port when MCP_TRANSPORT=sseMAX_JOB_OUTPUT_LINESMax lines returned from a single spool DDMAX_DATASET_READ_LINESMax lines returned from dataset or USS readsMAX_JES_SPOOL_FILESMax spool files fetched during diagnosticsMAX_AUDIT_LINESMax RACF audit log lines per queryCMCI_HOSTCMCI hostname (defaults to ZOSMF_HOST)CMCI_PORTCMCI HTTPS port (default 1490)CMCI_BASE_PATHCMCI REST base pathDB2_HOSTDb2 REST hostname (defaults to ZOSMF_HOST)DB2_PORTDb2 REST port (default 50400)DB2_BASE_PATHDb2 REST base pathSMF_SUMMARY_DATASETOptional SMF summary dataset for offline metricsRMF_METRICS_ENABLEDQuery z/OSMF RMF metrics when availableRACF_AUDIT_USS_PATHUSS path to RACF audit log fileRACF_AUDIT_DATASETSequential dataset containing RACF audit recordsSECURITY_READ_ONLYWhen true (default), blocks write tools such as submit_jclSECURITY_ALLOWED_TOOLSComma-separated allowlist of MCP tool namesSECURITY_BLOCKED_TOOLSComma-separated blocklist of MCP tool namesSECURITY_ALLOWED_DATASET_PATTERNSComma-separated dataset patterns (e.g. USERDEV.*,SYS1.*)SECURITY_ALLOWED_USS_PATHSComma-separated USS path prefixesSECURITY_AUDIT_LOGGINGLog every tool invocation to stderr (SIEM-friendly JSON)SECURITY_MAX_JCL_BYTESMaximum inline JCL size for submit_jclSECURITY_WRITE_APPROVALHuman-in-the-loop: submit_jcl returns a one-time token and approve_write executes (default false)SECURITY_JCL_SCANPre-flight scan JCL before submission: IDCAMS DELETE, IEFBR14 DISP DELETE, blocked utilities (default true)SECURITY_JCL_SCAN_STRICTStrict scan mode: WARN findings also block submissions (default false)SECURITY_BLOCKED_PROGRAMSComma-separated EXEC programs that may never run (extends ADRDSSU,ICKDSF,IEHINITT)SECURITY_BLOCKED_JOB_CLASSESComma-separated JES job classes that may never be usedSECURITY_CHANGE_TICKET_PATTERNRegex a changeTicket argument must match on writes, e.g. CHG[0-9]{6}SECURITY_WRITE_WINDOWAllowed write window, 24h HH:MM-HH:MM (overnight ranges allowed), e.g. 08:00-18:00SECURITY_WRITE_DAYSWeekdays writes are allowed: 0=Sun..6=Sat, e.g. 1-5SECURITY_WRITE_WINDOW_TZIANA timezone for the write window (default UTC)
説明は英語の原文のままです。
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげますが、先に準備が必要です
Mainframe MCP Server のキーが必要です(提供元のサイトで作成) · 設定を 4 項目入力 (ZOSMF_HOST, ZOSMF_USER, CMCI_CONTEXT, DB2_LOCATION) · 先にパソコンへ Node.js を入れてください(1 回だけ)
Mainframe MCP Server に登録してキーを作る
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
設定を 4 項目入力
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
ZOSMF_HOSTz/OSMF hostname or IP addressZOSMF_USERz/OS user id (required with ZOSMF_PASSWORD unless ZOSMF_TOKEN is set)CMCI_CONTEXTCICSplex name or region APPLID (required for CICS tools)DB2_LOCATIONDb2 subsystem location name (required for Db2 tools)
説明は英語の原文のままです。
キーを入力
Mainframe MCP Server の設定で ZOSMF_PASSWORD, ZOSMF_TOKEN, ZOSMF_TOKEN_TYPE, ZOSMF_CERT_KEY, ZOSMF_HOST, ZOSMF_USER, CMCI_CONTEXT, DB2_LOCATION が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
VS Code の AI チャットを Agent モードで開く
試してみる
Mainframe MCP Server を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が Mainframe MCP Server を使っていると言うか、回答に Mainframe MCP Server のツール名が出れば接続成功です
追加の設定 42 項目(入力しなくても使えます)
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
ZOSMF_PORTz/OSMF HTTPS port (default 443)ZOSMF_BASE_PATHOptional API gateway or mediation layer prefix for z/OSMFZOSMF_REJECT_UNAUTHORIZEDVerify TLS certificates (true in production)ZOSMF_CERTPEM client certificate file path for mTLS authZOSMF_TOKEN_FILERead ZOSMF_TOKEN from this file at startup (vault/agent injection)ZOSMF_USER_IDEnd-user id for PassTicket identity propagation (RACF sees this user, not the service account)ZOSMF_PASSTICKET_APPRACF PTKTDATA application name for PassTicket generation (default ZOSMF)ZOWE_TEAM_CONFIGPath to a zowe.config.json to import connection settings from (env vars win)ZOSMF_PROFILEProfile name inside the Zowe team config (defaults to defaults.zosmf)LOG_LEVELLog level: fatal, error, warn, info, debug, trace, silentMCP_TRANSPORTTransport: stdio (IDE) or sse (legacy HTTP+SSE for container/network deployments)MCP_SSE_PORTListen port when MCP_TRANSPORT=sseMAX_JOB_OUTPUT_LINESMax lines returned from a single spool DDMAX_DATASET_READ_LINESMax lines returned from dataset or USS readsMAX_JES_SPOOL_FILESMax spool files fetched during diagnosticsMAX_AUDIT_LINESMax RACF audit log lines per queryCMCI_HOSTCMCI hostname (defaults to ZOSMF_HOST)CMCI_PORTCMCI HTTPS port (default 1490)CMCI_BASE_PATHCMCI REST base pathDB2_HOSTDb2 REST hostname (defaults to ZOSMF_HOST)DB2_PORTDb2 REST port (default 50400)DB2_BASE_PATHDb2 REST base pathSMF_SUMMARY_DATASETOptional SMF summary dataset for offline metricsRMF_METRICS_ENABLEDQuery z/OSMF RMF metrics when availableRACF_AUDIT_USS_PATHUSS path to RACF audit log fileRACF_AUDIT_DATASETSequential dataset containing RACF audit recordsSECURITY_READ_ONLYWhen true (default), blocks write tools such as submit_jclSECURITY_ALLOWED_TOOLSComma-separated allowlist of MCP tool namesSECURITY_BLOCKED_TOOLSComma-separated blocklist of MCP tool namesSECURITY_ALLOWED_DATASET_PATTERNSComma-separated dataset patterns (e.g. USERDEV.*,SYS1.*)SECURITY_ALLOWED_USS_PATHSComma-separated USS path prefixesSECURITY_AUDIT_LOGGINGLog every tool invocation to stderr (SIEM-friendly JSON)SECURITY_MAX_JCL_BYTESMaximum inline JCL size for submit_jclSECURITY_WRITE_APPROVALHuman-in-the-loop: submit_jcl returns a one-time token and approve_write executes (default false)SECURITY_JCL_SCANPre-flight scan JCL before submission: IDCAMS DELETE, IEFBR14 DISP DELETE, blocked utilities (default true)SECURITY_JCL_SCAN_STRICTStrict scan mode: WARN findings also block submissions (default false)SECURITY_BLOCKED_PROGRAMSComma-separated EXEC programs that may never run (extends ADRDSSU,ICKDSF,IEHINITT)SECURITY_BLOCKED_JOB_CLASSESComma-separated JES job classes that may never be usedSECURITY_CHANGE_TICKET_PATTERNRegex a changeTicket argument must match on writes, e.g. CHG[0-9]{6}SECURITY_WRITE_WINDOWAllowed write window, 24h HH:MM-HH:MM (overnight ranges allowed), e.g. 08:00-18:00SECURITY_WRITE_DAYSWeekdays writes are allowed: 0=Sun..6=Sat, e.g. 1-5SECURITY_WRITE_WINDOW_TZIANA timezone for the write window (default UTC)
説明は英語の原文のままです。
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください
JSON 設定は下の「開発者向け」にあります
開発者向け:ターミナルのコマンドと JSON 設定
パソコンにインストール
Claude Code
claude mcp add --scope user mainframe --env ZOSMF_HOST=your-value --env ZOSMF_USER=your-value --env ZOSMF_PASSWORD=your-value --env ZOSMF_TOKEN=your-value --env ZOSMF_TOKEN_TYPE=your-value --env ZOSMF_CERT_KEY=your-value --env CMCI_CONTEXT=your-value --env DB2_LOCATION=your-value -- npx -y @notharshhaa/mainframe-mcp-serverClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"mainframe": {
"command": "npx",
"args": [
"-y",
"@notharshhaa/mainframe-mcp-server"
],
"env": {
"ZOSMF_HOST": "your-value",
"ZOSMF_USER": "your-value",
"ZOSMF_PASSWORD": "your-value",
"ZOSMF_TOKEN": "your-value",
"ZOSMF_TOKEN_TYPE": "your-value",
"ZOSMF_CERT_KEY": "your-value",
"CMCI_CONTEXT": "your-value",
"DB2_LOCATION": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"mainframe": {
"command": "npx",
"args": [
"-y",
"@notharshhaa/mainframe-mcp-server"
],
"env": {
"ZOSMF_HOST": "your-value",
"ZOSMF_USER": "your-value",
"ZOSMF_PASSWORD": "your-value",
"ZOSMF_TOKEN": "your-value",
"ZOSMF_TOKEN_TYPE": "your-value",
"ZOSMF_CERT_KEY": "your-value",
"CMCI_CONTEXT": "your-value",
"DB2_LOCATION": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"mainframe": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@notharshhaa/mainframe-mcp-server"
],
"env": {
"ZOSMF_HOST": "your-value",
"ZOSMF_USER": "your-value",
"ZOSMF_PASSWORD": "your-value",
"ZOSMF_TOKEN": "your-value",
"ZOSMF_TOKEN_TYPE": "your-value",
"ZOSMF_CERT_KEY": "your-value",
"CMCI_CONTEXT": "your-value",
"DB2_LOCATION": "your-value"
}
}
}
}自分で入力する値
ZOSMF_HOST必須 envz/OSMF hostname or IP addressZOSMF_PORTenvz/OSMF HTTPS port (default 443)ZOSMF_BASE_PATHenvOptional API gateway or mediation layer prefix for z/OSMFZOSMF_USER必須 envz/OS user id (required with ZOSMF_PASSWORD unless ZOSMF_TOKEN is set)ZOSMF_PASSWORD秘密 必須 envPassword for basic auth (required with ZOSMF_USER unless ZOSMF_TOKEN is set)ZOSMF_TOKEN秘密 必須 envAuth token (alternative to user/password)ZOSMF_TOKEN_TYPE秘密 必須 envToken type when using ZOSMF_TOKEN (e.g. LTPA2)ZOSMF_REJECT_UNAUTHORIZEDenvVerify TLS certificates (true in production)ZOSMF_CERTenvPEM client certificate file path for mTLS authZOSMF_CERT_KEY秘密 必須 envPEM client key file path for mTLS auth (required with ZOSMF_CERT)ZOSMF_TOKEN_FILEenvRead ZOSMF_TOKEN from this file at startup (vault/agent injection)ZOSMF_USER_IDenvEnd-user id for PassTicket identity propagation (RACF sees this user, not the service account)ZOSMF_PASSTICKET_APPenvRACF PTKTDATA application name for PassTicket generation (default ZOSMF)ZOWE_TEAM_CONFIGenvPath to a zowe.config.json to import connection settings from (env vars win)ZOSMF_PROFILEenvProfile name inside the Zowe team config (defaults to defaults.zosmf)LOG_LEVELenvLog level: fatal, error, warn, info, debug, trace, silentMCP_TRANSPORTenvTransport: stdio (IDE) or sse (legacy HTTP+SSE for container/network deployments)MCP_SSE_PORTenvListen port when MCP_TRANSPORT=sseMAX_JOB_OUTPUT_LINESenvMax lines returned from a single spool DDMAX_DATASET_READ_LINESenvMax lines returned from dataset or USS readsMAX_JES_SPOOL_FILESenvMax spool files fetched during diagnosticsMAX_AUDIT_LINESenvMax RACF audit log lines per queryCMCI_CONTEXT必須 envCICSplex name or region APPLID (required for CICS tools)CMCI_HOSTenvCMCI hostname (defaults to ZOSMF_HOST)CMCI_PORTenvCMCI HTTPS port (default 1490)CMCI_BASE_PATHenvCMCI REST base pathDB2_LOCATION必須 envDb2 subsystem location name (required for Db2 tools)DB2_HOSTenvDb2 REST hostname (defaults to ZOSMF_HOST)DB2_PORTenvDb2 REST port (default 50400)DB2_BASE_PATHenvDb2 REST base pathSMF_SUMMARY_DATASETenvOptional SMF summary dataset for offline metricsRMF_METRICS_ENABLEDenvQuery z/OSMF RMF metrics when availableRACF_AUDIT_USS_PATHenvUSS path to RACF audit log fileRACF_AUDIT_DATASETenvSequential dataset containing RACF audit recordsSECURITY_READ_ONLYenvWhen true (default), blocks write tools such as submit_jclSECURITY_ALLOWED_TOOLSenvComma-separated allowlist of MCP tool namesSECURITY_BLOCKED_TOOLSenvComma-separated blocklist of MCP tool namesSECURITY_ALLOWED_DATASET_PATTERNSenvComma-separated dataset patterns (e.g. USERDEV.*,SYS1.*)SECURITY_ALLOWED_USS_PATHSenvComma-separated USS path prefixesSECURITY_AUDIT_LOGGINGenvLog every tool invocation to stderr (SIEM-friendly JSON)SECURITY_MAX_JCL_BYTESenvMaximum inline JCL size for submit_jclSECURITY_WRITE_APPROVALenvHuman-in-the-loop: submit_jcl returns a one-time token and approve_write executes (default false)SECURITY_JCL_SCANenvPre-flight scan JCL before submission: IDCAMS DELETE, IEFBR14 DISP DELETE, blocked utilities (default true)SECURITY_JCL_SCAN_STRICTenvStrict scan mode: WARN findings also block submissions (default false)SECURITY_BLOCKED_PROGRAMSenvComma-separated EXEC programs that may never run (extends ADRDSSU,ICKDSF,IEHINITT)SECURITY_BLOCKED_JOB_CLASSESenvComma-separated JES job classes that may never be usedSECURITY_CHANGE_TICKET_PATTERNenvRegex a changeTicket argument must match on writes, e.g. CHG[0-9]{6}SECURITY_WRITE_WINDOWenvAllowed write window, 24h HH:MM-HH:MM (overnight ranges allowed), e.g. 08:00-18:00SECURITY_WRITE_DAYSenvWeekdays writes are allowed: 0=Sun..6=Sat, e.g. 1-5SECURITY_WRITE_WINDOW_TZenvIANA timezone for the write window (default UTC)
説明は英語の原文のままです。
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
ひと目でわかる
使えるアプリ
このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
できること
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
基本チェックi
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月14日にチェック
- ✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント NotHarshhaa で確認済みです
- ✓ 合格
今もメンテナンスされている
コードの最終更新:17 日前
- ✓ 合格
ライセンスがある
MITを使用
- – 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
- – 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
- … 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
話し合い
質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
ユーザーレビュー
まだレビューはありません
データベース・データセットのほかのサーバーとの比較i
- このカテゴリのほかの1190件のうち0%よりスターが多い
- このカテゴリのほかの1190件のうち68%より最近レジストリに公開
- 基本チェックの結果が、このカテゴリのほかの1190件のうち100%と同じかそれ以上
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
よくある質問
Mainframe MCP Serverは安全ですか?
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
どんなキーやコードが必要ですか?
入力が必要なもの:ZOSMF_PASSWORD, ZOSMF_TOKEN, ZOSMF_TOKEN_TYPE, ZOSMF_CERT_KEY
パソコンで動きますか、それともクラウドですか?
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
今もメンテナンスされていますか?
GitHubリポジトリの最終更新は17 日前、最新バージョン(3.0.0)がレジストリに届いたのは20 日前です。
どのアプリで使えますか?
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。
代わりに使えるものは?
同じカテゴリには:Dbx, MCP Toolbox for Databases, MCP Toolbox for Databases
同じカテゴリのほかの候補
同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
MCP Toolbox for Databases
MCP Toolbox for Databases enables your agent to connect to your database.
MCP Toolbox for Databases
MCP Toolbox for Databases enables your agent to connect to your database.
作者のREADME
READMEを開く
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
mainframe-mcp-server
MCP Server for IBM z/OS using Zowe APIs
An enterprise-grade Model Context Protocol (MCP) server for IBM z/OS environments.
Bridges MCP-compatible AI agents with mainframe resources — jobs, datasets, USS, and operational diagnostics — using the Zowe SDK (Open Mainframe Project) as the connectivity layer.
Contents
- What it does
- How it's different
- z/OS prerequisites
- Tools
- Prompts & resources (MCP-native surface)
- Enterprise security
- Enterprise features
- Per-user identity & SSO
- Governed writes
- Trust model & prompt injection
- How the intelligence tools work
- Incident management & runbooks
- Quick start
- Transports
- Limits & timeouts
- Troubleshooting & FAQ
- Examples
- Project & community
- License
- Trademarks
What it does
mainframe-mcp-server exposes z/OS capabilities as Model Context Protocol tools. An AI agent can list jobs, read datasets, inspect USS paths, submit JCL, and run operational diagnostics — without you writing Zowe CLI commands by hand.
Connectivity is handled by the Zowe SDK (Open Mainframe Project) over z/OSMF REST. This project adds the MCP tool layer, input validation, safety limits, and AI-friendly response formatting on top.
How it's different
| mainframe-mcp-server | Zowe CLI + scripts | Host IDE tooling (IDz, Z Open Editor) | Other z/OS MCP bridges | |
|---|---|---|---|---|
| Interface | MCP tools for AI agents | Terminal commands, shell scripts | Eclipse/VS Code GUIs | MCP tools for AI agents |
| Output | Structured sections & tables tuned for LLM reasoning | Raw terminal text you must parse yourself | IDE views | Varies by project |
| Guardrails | Read-only by default, tool allow/block lists, dataset & USS boundaries, audit logging, JCL size cap | None built in — you script them | Client-side only | Varies by project |
| Failure knowledge | Curated abend-code reference, failing-step heuristics, risk scoring | Manual message lookup | Interactive debugging | Rare |
| Install | npx — no server-side footprint beyond z/OSMF access | Node + Zowe CLI + your scripts | Full IDE estate | Often heavier runtimes |
| Coverage | Jobs, datasets, USS, CICS, Db2, SMF/RMF, RACF audit (30+ tools) | Full Zowe command set | Edit, debug, compile | Varies |
Honest positioning: the z/OS MCP ecosystem is early. IBM and community authors publish their own MCP bridges — evaluate them against your requirements. This project's differentiators are zero-dependency npm install, guardrails enforced at the server layer, and output shaped for LLM consumption rather than human eyes. It is not a replacement for Zowe CLI or IBM Z Open Editor — it is an MCP bridge over the same z/OSMF APIs.
z/OS prerequisites
The server is a pure client — nothing is installed on z/OS. It requires REST services that are enabled in standard z/OSMF estates.
z/OSMF (required — all core tools)
| z/OSMF REST service | Used by | Notes |
|---|---|---|
Jobs REST (/zosmf/restjobs/jobs) | list_jobs, get_job_status, get_job_output, get_job_jcl, submit_jcl, all operations & intelligence tools | List, query, spool content, JES submit |
Files REST — datasets (/zosmf/restfiles/ds) | list_datasets, search_dataset, read_dataset, search_members, get_dataset_info | Catalog list, members, content read |
Files REST — USS (/zosmf/restfiles/fs) | list_uss_directory, read_uss_file, search_uss_files, RACF audit source | Directory list, file read |
z/OSMF info (/info) | verify_zosmf_connection | Optional; version read-out only |
RMF REST (/rmf/mvs/GPO/) | get_smf_metrics | Optional; disabled with RMF_METRICS_ENABLED=false |
Baseline: z/OS 2.4 LTS or later with APAR-current z/OSMF — the target the Zowe SDK (v8) is built against. Core job/dataset/USS tools are expected to work on z/OSMF levels from z/OS 2.3 onward; if you run an older or unusual level, open an issue with your results so the matrix can be updated.
CICS via CMCI (optional — list_cics_regions, get_cics_region_status, list_cics_transactions)
- CICS TS 5.4 or later with CMCI active (a CICSPlex SM WUI region, or a single-region CMCI setup).
- Set
CMCI_CONTEXT(CICSplex name or region APPLID); optionallyCMCI_HOST,CMCI_PORT(default1490),CMCI_BASE_PATH(default/CICSSystemManagement). - The service account needs RACF/SAF authority to the CMCI data sets (
XCSDATA/CICSPLEXresource classes as configured at your site).
Db2 REST (optional — list_db2_subsystems, search_db2_catalog)
- Db2 12 for z/OS or later with the Db2 REST services capability exposed at
DB2_HOST:DB2_PORT(default50400, base path/dbrest) — direct DDF-served REST or fronted by your API mediation layer. - Set
DB2_LOCATION(the subsystem location name). Tools run read-only catalog SQL againstSYSIBM.SYSTABLESwith literal-escaped, size-capped input.
RACF audit source (optional — query_racf_audit)
- An existing audit extract the service account can read: a USS log file (
RACF_AUDIT_USS_PATH) or a sequential dataset (RACF_AUDIT_DATASET), e.g. ADUINFOS/IRRADU00 output written to file. The server parses the text; it does not run IRRADU00 for you.
Service account
Use a dedicated z/OS user with least-privilege RACF profiles (job list/read authority, submit authority only if SECURITY_READ_ONLY=false).
Tools
Type legend: READ — reads z/OS state, never modifies anything · WRITE — submits work to JES · OFFLINE — no mainframe I/O at all.
Jobs
| Tool | Type | Description |
|---|---|---|
list_jobs | READ | List jobs by owner, prefix, or status |
get_job_status | READ | Status and return code for a job |
get_job_output | READ | Spool inventory or DD content |
submit_jcl | WRITE | Submit inline JCL — governed by pre-flight scan, change ticket, change window, and optional human approval |
approve_write | WRITE | Execute a pending JCL submission after human review (requires SECURITY_WRITE_APPROVAL=true) |
analyze_job_failure | READ | Abend code, failing step, and suggested fix |
get_job_jcl | READ | Retrieve submitted JCL from job spool |
Datasets
| Tool | Type | Description |
|---|---|---|
list_datasets | READ | List datasets matching an HLQ pattern |
read_dataset | READ | Read a sequential dataset or PDS member |
search_dataset | READ | Search datasets by pattern |
search_members | READ | Search or list PDS members |
get_dataset_info | READ | Catalog attributes without reading content |
USS
| Tool | Type | Description |
|---|---|---|
list_uss_directory | READ | List a USS directory |
read_uss_file | READ | Read a USS file |
search_uss_files | READ | Search files under a USS path |
Operations
| Tool | Type | Description |
|---|---|---|
find_failed_jobs | READ | Failed jobs in a time window |
summarize_abends | READ | Abend code breakdown across recent jobs |
system_health_summary | READ | Active, queued, and failed job snapshot |
investigate_incident | READ | Full incident bundle for a job |
lookup_abend_code | OFFLINE | Abend reference lookup (S0C7, S806, S222, S0C4, …) |
verify_zosmf_connection | READ | Test z/OSMF connectivity and auth |
compare_jobs | READ | Side-by-side comparison of two jobs |
get_user_jobs_summary | READ | Job counts by status for an owner |
CICS
Requires optional CMCI configuration — see z/OS prerequisites.
| Tool | Type | Description |
|---|---|---|
list_cics_regions | READ | List CICS regions via CMCI REST |
get_cics_region_status | READ | Status and attributes of a CICS region |
list_cics_transactions | READ | Transaction definitions in a region |
get_cics_region_stats | READ | Region statistics/attributes from the CMCI CICSRegion resource |
cics_newcopy | WRITE | NEWCOPY a program via CMCI action (CICS TS 5.6+) |
cics_disable_transaction | WRITE | Disable/enable a local transaction via CMCI SET action |
Db2
Requires optional Db2 REST configuration — see z/OS prerequisites.
| Tool | Type | Description |
|---|---|---|
list_db2_subsystems | READ | List Db2 locations via Db2 REST |
search_db2_catalog | READ | Read-only catalog search (tables, views, aliases) |
Console & JES
Operator commands run through an extended MCS console (ZOSMF_CONSOLE_NAME); command tools are gated writes subject to read-only mode, policy roles, change tickets, and change windows.
| Tool | Type | Description |
|---|---|---|
issue_console_command | WRITE | MVS commands (D A,L, D GRS,RES=…) with follow-up message collection |
get_console_messages | READ | Operations-log tail (SYSLOG-style console feed) |
hold_job / release_job | WRITE | JES2 $HJ / $OJ job hold and release |
cancel_job | WRITE | Cancel a job via the z/OSMF jobs API |
get_wlm_status | WRITE | D WLM display (service policy / resources) |
ims_command | WRITE | IMS commands via the system console (/DIS ACTIVE, /DIS TRAN …) |
get_hsm_activity | READ | DFSMShsm recall/migration activity from the operations log |
analyze_logrec | WRITE | Submit an EREP report against LOGREC and summarize error records |
Schedulers
| Tool | Type | Description |
|---|---|---|
scheduler_job_status | READ | Control-M / CA 7 / IBM WLS job status via their REST APIs (SCHEDULER_ADAPTERS) |
| job_dependencies | READ | JCL dataset-flow analysis — inputs, outp