Mainframe MCP Server

Name: Mainframe MCP Server
Author: NotHarshhaa

제작자: NotHarshhaa버전 3.0.0i★ 0i내 컴퓨터에서 실행

레지스트리 이름io.github.NotHarshhaa/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웹 · 앱 · 모바일ChatGPT웹Claude Code터미널Cursor코드 에디터VS Code코드 에디터기타다른 앱

쓰는 앱을 고르면 아래에 단계가 나옵니다.

Claude에 연결할 수 있지만 먼저 준비가 필요해요

Mainframe MCP Server 키가 필요해요 (제작자 사이트에서 만들기) · 설정 4개 입력 필요 (ZOSMF_HOST, ZOSMF_USER, CMCI_CONTEXT, DB2_LOCATION) · 먼저 컴퓨터에 Node.js를 설치하세요 (한 번만) · 컴퓨터용 Claude 앱(Windows 또는 Mac)에서만 되고 웹이나 모바일은 안 돼요

AI에게 설치 맡기기

이 메시지를 Claude 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.

이 컴퓨터의 Claude에 MCP server Mainframe MCP Server을 설치해 주세요. 순서대로: 1) node -v로 Node.js가 있는지 확인. 없으면 https://nodejs.org/en/download에서 설치하라고 알려 주고 직접 설치하지 마세요. 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): { "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" } } } } 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) ZOSMF_PASSWORD, ZOSMF_TOKEN, ZOSMF_TOKEN_TYPE, ZOSMF_CERT_KEY, ZOSMF_HOST, ZOSMF_USER, CMCI_CONTEXT, DB2_LOCATION에는 "your-value"를 그대로 두고, 실제 값은 제가 파일이나 앱 입력란에 직접 붙여 넣도록 안내하세요. 채팅에 키를 입력하라고 하지 마세요. 5) 합의한 대로 실행한 뒤 Mainframe MCP Server의 도구가 실제로 보이는지 확인하세요.

이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.

1
Node.js 설치 (아직 없다면)
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
node -v
- 버전 번호(예: v26.13.1)가 나오면 설치된 것입니다. 이 단계는 건너뛰세요
- "command not found"(Windows는 "is not recognized")가 나오면 아직 설치하지 않았거나, 방금 설치해서 터미널을 닫았다가 다시 열어야 합니다
터미널 여는 법
Mac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다
Node.js 다운로드 페이지 열기 ↗
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다: node -v
한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다
완료
Mainframe MCP Server에 가입하고 키 만들기
제작자 사이트에서 가입하고 다음 단계에 쓸 API 키를 만드세요. 요금과 무료 요금제는 제작자 사이트에서 확인하세요.
키 받는 방법은 아래 제작자 README에 있어요
완료
3
설정 4개 입력
이것은 프로그램 설정이며 키가 아닙니다. 가입할 필요 없이 제작자 설명대로 입력하세요.
- ZOSMF_HOST z/OSMF hostname or IP address
- ZOSMF_USER z/OS user id (required with ZOSMF_PASSWORD unless ZOSMF_TOKEN is set)
- CMCI_CONTEXT CICSplex name or region APPLID (required for CICS tools)
- DB2_LOCATION Db2 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을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐
✓ Claude가 Mainframe MCP Server을 쓰고 있다고 하거나 답에 Mainframe MCP Server 도구 이름이 나오면 연결된 거예요

추가 설정 42개 (입력하지 않아도 사용 가능)

위 명령은 이 값들 없이도 동작합니다. 바꾸고 싶을 때만 제작자 설명대로 추가하세요.

ZOSMF_PORT z/OSMF HTTPS port (default 443)
ZOSMF_BASE_PATH Optional API gateway or mediation layer prefix for z/OSMF
ZOSMF_REJECT_UNAUTHORIZED Verify TLS certificates (true in production)
ZOSMF_CERT PEM client certificate file path for mTLS auth
ZOSMF_TOKEN_FILE Read ZOSMF_TOKEN from this file at startup (vault/agent injection)
ZOSMF_USER_ID End-user id for PassTicket identity propagation (RACF sees this user, not the service account)
ZOSMF_PASSTICKET_APP RACF PTKTDATA application name for PassTicket generation (default ZOSMF)
ZOWE_TEAM_CONFIG Path to a zowe.config.json to import connection settings from (env vars win)
ZOSMF_PROFILE Profile name inside the Zowe team config (defaults to defaults.zosmf)
LOG_LEVEL Log level: fatal, error, warn, info, debug, trace, silent
MCP_TRANSPORT Transport: stdio (IDE) or sse (legacy HTTP+SSE for container/network deployments)
MCP_SSE_PORT Listen port when MCP_TRANSPORT=sse
MAX_JOB_OUTPUT_LINES Max lines returned from a single spool DD
MAX_DATASET_READ_LINES Max lines returned from dataset or USS reads
MAX_JES_SPOOL_FILES Max spool files fetched during diagnostics
MAX_AUDIT_LINES Max RACF audit log lines per query
CMCI_HOST CMCI hostname (defaults to ZOSMF_HOST)
CMCI_PORT CMCI HTTPS port (default 1490)
CMCI_BASE_PATH CMCI REST base path
DB2_HOST Db2 REST hostname (defaults to ZOSMF_HOST)
DB2_PORT Db2 REST port (default 50400)
DB2_BASE_PATH Db2 REST base path
SMF_SUMMARY_DATASET Optional SMF summary dataset for offline metrics
RMF_METRICS_ENABLED Query z/OSMF RMF metrics when available
RACF_AUDIT_USS_PATH USS path to RACF audit log file
RACF_AUDIT_DATASET Sequential dataset containing RACF audit records
SECURITY_READ_ONLY When true (default), blocks write tools such as submit_jcl
SECURITY_ALLOWED_TOOLS Comma-separated allowlist of MCP tool names
SECURITY_BLOCKED_TOOLS Comma-separated blocklist of MCP tool names
SECURITY_ALLOWED_DATASET_PATTERNS Comma-separated dataset patterns (e.g. USERDEV.*,SYS1.*)
SECURITY_ALLOWED_USS_PATHS Comma-separated USS path prefixes
SECURITY_AUDIT_LOGGING Log every tool invocation to stderr (SIEM-friendly JSON)
SECURITY_MAX_JCL_BYTES Maximum inline JCL size for submit_jcl
SECURITY_WRITE_APPROVAL Human-in-the-loop: submit_jcl returns a one-time token and approve_write executes (default false)
SECURITY_JCL_SCAN Pre-flight scan JCL before submission: IDCAMS DELETE, IEFBR14 DISP DELETE, blocked utilities (default true)
SECURITY_JCL_SCAN_STRICT Strict scan mode: WARN findings also block submissions (default false)
SECURITY_BLOCKED_PROGRAMS Comma-separated EXEC programs that may never run (extends ADRDSSU,ICKDSF,IEHINITT)
SECURITY_BLOCKED_JOB_CLASSES Comma-separated JES job classes that may never be used
SECURITY_CHANGE_TICKET_PATTERN Regex a changeTicket argument must match on writes, e.g. CHG[0-9]{6}
SECURITY_WRITE_WINDOW Allowed write window, 24h HH:MM-HH:MM (overnight ranges allowed), e.g. 08:00-18:00
SECURITY_WRITE_DAYS Weekdays writes are allowed: 0=Sun..6=Sat, e.g. 1-5
SECURITY_WRITE_WINDOW_TZ IANA timezone for the write window (default UTC)

설명은 아직 영어 원문입니다.

메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

ChatGPT는 아직 Mainframe MCP Server에 연결할 수 없어요

Mainframe MCP Server는 내 컴퓨터에 설치해서 쓰지만 ChatGPT는 웹에서 도는 서버만 연결할 수 있어요

대신 이렇게 할 수 있어요

A · Mainframe MCP Server에 연결되는 앱 쓰기

Claude 단계 보기 →Mainframe MCP Server 키가 필요해요 (제작자 사이트에서 만들기) · 설정 4개 입력 필요 (ZOSMF_HOST, ZOSMF_USER, CMCI_CONTEXT, DB2_LOCATION) · 먼저 컴퓨터에 Node.js를 설치하세요 (한 번만) · 컴퓨터용 Claude 앱(Windows 또는 Mac)에서만 되고 웹이나 모바일은 안 돼요
Claude Code 단계 보기 →Mainframe MCP Server 키가 필요해요 (제작자 사이트에서 만들기) · 설정 4개 입력 필요 (ZOSMF_HOST, ZOSMF_USER, CMCI_CONTEXT, DB2_LOCATION) · 먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)
Cursor 단계 보기 →Mainframe MCP Server 키가 필요해요 (제작자 사이트에서 만들기) · 설정 4개 입력 필요 (ZOSMF_HOST, ZOSMF_USER, CMCI_CONTEXT, DB2_LOCATION) · 먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)
VS Code 단계 보기 →Mainframe MCP Server 키가 필요해요 (제작자 사이트에서 만들기) · 설정 4개 입력 필요 (ZOSMF_HOST, ZOSMF_USER, CMCI_CONTEXT, DB2_LOCATION) · 먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)

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를 설치하세요 (한 번만)

AI에게 설치 맡기기

이 메시지를 Claude Code 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.

이 컴퓨터의 Claude Code에 MCP server Mainframe MCP Server을 설치해 주세요. 순서대로: 1) node -v로 Node.js가 있는지 확인. 없으면 https://nodejs.org/en/download에서 설치하라고 알려 주고 직접 설치하지 마세요. 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): 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-server 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) ZOSMF_PASSWORD, ZOSMF_TOKEN, ZOSMF_TOKEN_TYPE, ZOSMF_CERT_KEY, ZOSMF_HOST, ZOSMF_USER, CMCI_CONTEXT, DB2_LOCATION에는 "your-value"를 그대로 두고, 실제 값은 제가 파일이나 앱 입력란에 직접 붙여 넣도록 안내하세요. 채팅에 키를 입력하라고 하지 마세요. 5) 합의한 대로 실행한 뒤 Mainframe MCP Server의 도구가 실제로 보이는지 확인하세요.

이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.

1
Node.js 설치 (아직 없다면)
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
node -v
- 버전 번호(예: v26.13.1)가 나오면 설치된 것입니다. 이 단계는 건너뛰세요
- "command not found"(Windows는 "is not recognized")가 나오면 아직 설치하지 않았거나, 방금 설치해서 터미널을 닫았다가 다시 열어야 합니다
터미널 여는 법
Mac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다
Node.js 다운로드 페이지 열기 ↗
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다: node -v
한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다
완료
Mainframe MCP Server에 가입하고 키 만들기
제작자 사이트에서 가입하고 다음 단계에 쓸 API 키를 만드세요. 요금과 무료 요금제는 제작자 사이트에서 확인하세요.
키 받는 방법은 아래 제작자 README에 있어요
완료
3
설정 4개 입력
이것은 프로그램 설정이며 키가 아닙니다. 가입할 필요 없이 제작자 설명대로 입력하세요.
- ZOSMF_HOST z/OSMF hostname or IP address
- ZOSMF_USER z/OS user id (required with ZOSMF_PASSWORD unless ZOSMF_TOKEN is set)
- CMCI_CONTEXT CICSplex name or region APPLID (required for CICS tools)
- DB2_LOCATION Db2 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-server

Enter 전에 “your-value”를 내 키로 바꾸세요

키는 앱 입력란에만 붙여 넣고, 채팅에 붙이거나 다른 사람에게 보내지 마세요

완료

Claude Code에서 /mcp 입력
Mainframe MCP Server이 목록에 있고 연결됨으로 보이면 돼요
완료
해 보기
Mainframe MCP Server을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐
✓ Claude Code가 Mainframe MCP Server을 쓰고 있다고 하거나 답에 Mainframe MCP Server 도구 이름이 나오면 연결된 거예요

추가 설정 42개 (입력하지 않아도 사용 가능)

위 명령은 이 값들 없이도 동작합니다. 바꾸고 싶을 때만 제작자 설명대로 추가하세요.

ZOSMF_PORT z/OSMF HTTPS port (default 443)
ZOSMF_BASE_PATH Optional API gateway or mediation layer prefix for z/OSMF
ZOSMF_REJECT_UNAUTHORIZED Verify TLS certificates (true in production)
ZOSMF_CERT PEM client certificate file path for mTLS auth
ZOSMF_TOKEN_FILE Read ZOSMF_TOKEN from this file at startup (vault/agent injection)
ZOSMF_USER_ID End-user id for PassTicket identity propagation (RACF sees this user, not the service account)
ZOSMF_PASSTICKET_APP RACF PTKTDATA application name for PassTicket generation (default ZOSMF)
ZOWE_TEAM_CONFIG Path to a zowe.config.json to import connection settings from (env vars win)
ZOSMF_PROFILE Profile name inside the Zowe team config (defaults to defaults.zosmf)
LOG_LEVEL Log level: fatal, error, warn, info, debug, trace, silent
MCP_TRANSPORT Transport: stdio (IDE) or sse (legacy HTTP+SSE for container/network deployments)
MCP_SSE_PORT Listen port when MCP_TRANSPORT=sse
MAX_JOB_OUTPUT_LINES Max lines returned from a single spool DD
MAX_DATASET_READ_LINES Max lines returned from dataset or USS reads
MAX_JES_SPOOL_FILES Max spool files fetched during diagnostics
MAX_AUDIT_LINES Max RACF audit log lines per query
CMCI_HOST CMCI hostname (defaults to ZOSMF_HOST)
CMCI_PORT CMCI HTTPS port (default 1490)
CMCI_BASE_PATH CMCI REST base path
DB2_HOST Db2 REST hostname (defaults to ZOSMF_HOST)
DB2_PORT Db2 REST port (default 50400)
DB2_BASE_PATH Db2 REST base path
SMF_SUMMARY_DATASET Optional SMF summary dataset for offline metrics
RMF_METRICS_ENABLED Query z/OSMF RMF metrics when available
RACF_AUDIT_USS_PATH USS path to RACF audit log file
RACF_AUDIT_DATASET Sequential dataset containing RACF audit records
SECURITY_READ_ONLY When true (default), blocks write tools such as submit_jcl
SECURITY_ALLOWED_TOOLS Comma-separated allowlist of MCP tool names
SECURITY_BLOCKED_TOOLS Comma-separated blocklist of MCP tool names
SECURITY_ALLOWED_DATASET_PATTERNS Comma-separated dataset patterns (e.g. USERDEV.*,SYS1.*)
SECURITY_ALLOWED_USS_PATHS Comma-separated USS path prefixes
SECURITY_AUDIT_LOGGING Log every tool invocation to stderr (SIEM-friendly JSON)
SECURITY_MAX_JCL_BYTES Maximum inline JCL size for submit_jcl
SECURITY_WRITE_APPROVAL Human-in-the-loop: submit_jcl returns a one-time token and approve_write executes (default false)
SECURITY_JCL_SCAN Pre-flight scan JCL before submission: IDCAMS DELETE, IEFBR14 DISP DELETE, blocked utilities (default true)
SECURITY_JCL_SCAN_STRICT Strict scan mode: WARN findings also block submissions (default false)
SECURITY_BLOCKED_PROGRAMS Comma-separated EXEC programs that may never run (extends ADRDSSU,ICKDSF,IEHINITT)
SECURITY_BLOCKED_JOB_CLASSES Comma-separated JES job classes that may never be used
SECURITY_CHANGE_TICKET_PATTERN Regex a changeTicket argument must match on writes, e.g. CHG[0-9]{6}
SECURITY_WRITE_WINDOW Allowed write window, 24h HH:MM-HH:MM (overnight ranges allowed), e.g. 08:00-18:00
SECURITY_WRITE_DAYS Weekdays writes are allowed: 0=Sun..6=Sat, e.g. 1-5
SECURITY_WRITE_WINDOW_TZ IANA timezone for the write window (default UTC)

설명은 아직 영어 원문입니다.

메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

Cursor에 연결할 수 있지만 먼저 준비가 필요해요

AI에게 설치 맡기기

이 메시지를 Cursor 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.

이 컴퓨터의 Cursor에 MCP server Mainframe MCP Server을 설치해 주세요. 순서대로: 1) node -v로 Node.js가 있는지 확인. 없으면 https://nodejs.org/en/download에서 설치하라고 알려 주고 직접 설치하지 마세요. 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): { "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" } } } } 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) ZOSMF_PASSWORD, ZOSMF_TOKEN, ZOSMF_TOKEN_TYPE, ZOSMF_CERT_KEY, ZOSMF_HOST, ZOSMF_USER, CMCI_CONTEXT, DB2_LOCATION에는 "your-value"를 그대로 두고, 실제 값은 제가 파일이나 앱 입력란에 직접 붙여 넣도록 안내하세요. 채팅에 키를 입력하라고 하지 마세요. 5) 합의한 대로 실행한 뒤 Mainframe MCP Server의 도구가 실제로 보이는지 확인하세요.

이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.

1
Node.js 설치 (아직 없다면)
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
node -v
- 버전 번호(예: v26.13.1)가 나오면 설치된 것입니다. 이 단계는 건너뛰세요
- "command not found"(Windows는 "is not recognized")가 나오면 아직 설치하지 않았거나, 방금 설치해서 터미널을 닫았다가 다시 열어야 합니다
터미널 여는 법
Mac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다
Node.js 다운로드 페이지 열기 ↗
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다: node -v
한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다
완료
Mainframe MCP Server에 가입하고 키 만들기
제작자 사이트에서 가입하고 다음 단계에 쓸 API 키를 만드세요. 요금과 무료 요금제는 제작자 사이트에서 확인하세요.
키 받는 방법은 아래 제작자 README에 있어요
완료
3
설정 4개 입력
이것은 프로그램 설정이며 키가 아닙니다. 가입할 필요 없이 제작자 설명대로 입력하세요.
- ZOSMF_HOST z/OSMF hostname or IP address
- ZOSMF_USER z/OS user id (required with ZOSMF_PASSWORD unless ZOSMF_TOKEN is set)
- CMCI_CONTEXT CICSplex name or region APPLID (required for CICS tools)
- DB2_LOCATION Db2 subsystem location name (required for Db2 tools)
설명은 아직 영어 원문입니다.
완료
이 버튼으로 Cursor 열기
Cursor에서 열기
Cursor가 설치를 확인하면 Install을 누르세요
완료
키 입력
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을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐
✓ Cursor가 Mainframe MCP Server을 쓰고 있다고 하거나 답에 Mainframe MCP Server 도구 이름이 나오면 연결된 거예요

추가 설정 42개 (입력하지 않아도 사용 가능)

위 명령은 이 값들 없이도 동작합니다. 바꾸고 싶을 때만 제작자 설명대로 추가하세요.

ZOSMF_PORT z/OSMF HTTPS port (default 443)
ZOSMF_BASE_PATH Optional API gateway or mediation layer prefix for z/OSMF
ZOSMF_REJECT_UNAUTHORIZED Verify TLS certificates (true in production)
ZOSMF_CERT PEM client certificate file path for mTLS auth
ZOSMF_TOKEN_FILE Read ZOSMF_TOKEN from this file at startup (vault/agent injection)
ZOSMF_USER_ID End-user id for PassTicket identity propagation (RACF sees this user, not the service account)
ZOSMF_PASSTICKET_APP RACF PTKTDATA application name for PassTicket generation (default ZOSMF)
ZOWE_TEAM_CONFIG Path to a zowe.config.json to import connection settings from (env vars win)
ZOSMF_PROFILE Profile name inside the Zowe team config (defaults to defaults.zosmf)
LOG_LEVEL Log level: fatal, error, warn, info, debug, trace, silent
MCP_TRANSPORT Transport: stdio (IDE) or sse (legacy HTTP+SSE for container/network deployments)
MCP_SSE_PORT Listen port when MCP_TRANSPORT=sse
MAX_JOB_OUTPUT_LINES Max lines returned from a single spool DD
MAX_DATASET_READ_LINES Max lines returned from dataset or USS reads
MAX_JES_SPOOL_FILES Max spool files fetched during diagnostics
MAX_AUDIT_LINES Max RACF audit log lines per query
CMCI_HOST CMCI hostname (defaults to ZOSMF_HOST)
CMCI_PORT CMCI HTTPS port (default 1490)
CMCI_BASE_PATH CMCI REST base path
DB2_HOST Db2 REST hostname (defaults to ZOSMF_HOST)
DB2_PORT Db2 REST port (default 50400)
DB2_BASE_PATH Db2 REST base path
SMF_SUMMARY_DATASET Optional SMF summary dataset for offline metrics
RMF_METRICS_ENABLED Query z/OSMF RMF metrics when available
RACF_AUDIT_USS_PATH USS path to RACF audit log file
RACF_AUDIT_DATASET Sequential dataset containing RACF audit records
SECURITY_READ_ONLY When true (default), blocks write tools such as submit_jcl
SECURITY_ALLOWED_TOOLS Comma-separated allowlist of MCP tool names
SECURITY_BLOCKED_TOOLS Comma-separated blocklist of MCP tool names
SECURITY_ALLOWED_DATASET_PATTERNS Comma-separated dataset patterns (e.g. USERDEV.*,SYS1.*)
SECURITY_ALLOWED_USS_PATHS Comma-separated USS path prefixes
SECURITY_AUDIT_LOGGING Log every tool invocation to stderr (SIEM-friendly JSON)
SECURITY_MAX_JCL_BYTES Maximum inline JCL size for submit_jcl
SECURITY_WRITE_APPROVAL Human-in-the-loop: submit_jcl returns a one-time token and approve_write executes (default false)
SECURITY_JCL_SCAN Pre-flight scan JCL before submission: IDCAMS DELETE, IEFBR14 DISP DELETE, blocked utilities (default true)
SECURITY_JCL_SCAN_STRICT Strict scan mode: WARN findings also block submissions (default false)
SECURITY_BLOCKED_PROGRAMS Comma-separated EXEC programs that may never run (extends ADRDSSU,ICKDSF,IEHINITT)
SECURITY_BLOCKED_JOB_CLASSES Comma-separated JES job classes that may never be used
SECURITY_CHANGE_TICKET_PATTERN Regex a changeTicket argument must match on writes, e.g. CHG[0-9]{6}
SECURITY_WRITE_WINDOW Allowed write window, 24h HH:MM-HH:MM (overnight ranges allowed), e.g. 08:00-18:00
SECURITY_WRITE_DAYS Weekdays writes are allowed: 0=Sun..6=Sat, e.g. 1-5
SECURITY_WRITE_WINDOW_TZ IANA timezone for the write window (default UTC)

설명은 아직 영어 원문입니다.

메뉴 이름은 2026년 11월 11일에 Cursor 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

VS Code에 연결할 수 있지만 먼저 준비가 필요해요

AI에게 설치 맡기기

이 메시지를 VS Code 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.

이 컴퓨터의 VS Code에 MCP server Mainframe MCP Server을 설치해 주세요. 순서대로: 1) node -v로 Node.js가 있는지 확인. 없으면 https://nodejs.org/en/download에서 설치하라고 알려 주고 직접 설치하지 마세요. 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): { "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" } } } } 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) ZOSMF_PASSWORD, ZOSMF_TOKEN, ZOSMF_TOKEN_TYPE, ZOSMF_CERT_KEY, ZOSMF_HOST, ZOSMF_USER, CMCI_CONTEXT, DB2_LOCATION에는 "your-value"를 그대로 두고, 실제 값은 제가 파일이나 앱 입력란에 직접 붙여 넣도록 안내하세요. 채팅에 키를 입력하라고 하지 마세요. 5) 합의한 대로 실행한 뒤 Mainframe MCP Server의 도구가 실제로 보이는지 확인하세요.

이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.

1
Node.js 설치 (아직 없다면)
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
node -v
- 버전 번호(예: v26.13.1)가 나오면 설치된 것입니다. 이 단계는 건너뛰세요
- "command not found"(Windows는 "is not recognized")가 나오면 아직 설치하지 않았거나, 방금 설치해서 터미널을 닫았다가 다시 열어야 합니다
터미널 여는 법
Mac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다
Node.js 다운로드 페이지 열기 ↗
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다: node -v
한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다
완료
Mainframe MCP Server에 가입하고 키 만들기
제작자 사이트에서 가입하고 다음 단계에 쓸 API 키를 만드세요. 요금과 무료 요금제는 제작자 사이트에서 확인하세요.
키 받는 방법은 아래 제작자 README에 있어요
완료
3
설정 4개 입력
이것은 프로그램 설정이며 키가 아닙니다. 가입할 필요 없이 제작자 설명대로 입력하세요.
- ZOSMF_HOST z/OSMF hostname or IP address
- ZOSMF_USER z/OS user id (required with ZOSMF_PASSWORD unless ZOSMF_TOKEN is set)
- CMCI_CONTEXT CICSplex name or region APPLID (required for CICS tools)
- DB2_LOCATION Db2 subsystem location name (required for Db2 tools)
설명은 아직 영어 원문입니다.
완료
이 버튼으로 VS Code 열기
VS Code에서 열기
VS Code가 설치를 확인하면 Install을 누르세요
완료
키 입력
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을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐
✓ VS Code가 Mainframe MCP Server을 쓰고 있다고 하거나 답에 Mainframe MCP Server 도구 이름이 나오면 연결된 거예요

추가 설정 42개 (입력하지 않아도 사용 가능)

위 명령은 이 값들 없이도 동작합니다. 바꾸고 싶을 때만 제작자 설명대로 추가하세요.

ZOSMF_PORT z/OSMF HTTPS port (default 443)
ZOSMF_BASE_PATH Optional API gateway or mediation layer prefix for z/OSMF
ZOSMF_REJECT_UNAUTHORIZED Verify TLS certificates (true in production)
ZOSMF_CERT PEM client certificate file path for mTLS auth
ZOSMF_TOKEN_FILE Read ZOSMF_TOKEN from this file at startup (vault/agent injection)
ZOSMF_USER_ID End-user id for PassTicket identity propagation (RACF sees this user, not the service account)
ZOSMF_PASSTICKET_APP RACF PTKTDATA application name for PassTicket generation (default ZOSMF)
ZOWE_TEAM_CONFIG Path to a zowe.config.json to import connection settings from (env vars win)
ZOSMF_PROFILE Profile name inside the Zowe team config (defaults to defaults.zosmf)
LOG_LEVEL Log level: fatal, error, warn, info, debug, trace, silent
MCP_TRANSPORT Transport: stdio (IDE) or sse (legacy HTTP+SSE for container/network deployments)
MCP_SSE_PORT Listen port when MCP_TRANSPORT=sse
MAX_JOB_OUTPUT_LINES Max lines returned from a single spool DD
MAX_DATASET_READ_LINES Max lines returned from dataset or USS reads
MAX_JES_SPOOL_FILES Max spool files fetched during diagnostics
MAX_AUDIT_LINES Max RACF audit log lines per query
CMCI_HOST CMCI hostname (defaults to ZOSMF_HOST)
CMCI_PORT CMCI HTTPS port (default 1490)
CMCI_BASE_PATH CMCI REST base path
DB2_HOST Db2 REST hostname (defaults to ZOSMF_HOST)
DB2_PORT Db2 REST port (default 50400)
DB2_BASE_PATH Db2 REST base path
SMF_SUMMARY_DATASET Optional SMF summary dataset for offline metrics
RMF_METRICS_ENABLED Query z/OSMF RMF metrics when available
RACF_AUDIT_USS_PATH USS path to RACF audit log file
RACF_AUDIT_DATASET Sequential dataset containing RACF audit records
SECURITY_READ_ONLY When true (default), blocks write tools such as submit_jcl
SECURITY_ALLOWED_TOOLS Comma-separated allowlist of MCP tool names
SECURITY_BLOCKED_TOOLS Comma-separated blocklist of MCP tool names
SECURITY_ALLOWED_DATASET_PATTERNS Comma-separated dataset patterns (e.g. USERDEV.*,SYS1.*)
SECURITY_ALLOWED_USS_PATHS Comma-separated USS path prefixes
SECURITY_AUDIT_LOGGING Log every tool invocation to stderr (SIEM-friendly JSON)
SECURITY_MAX_JCL_BYTES Maximum inline JCL size for submit_jcl
SECURITY_WRITE_APPROVAL Human-in-the-loop: submit_jcl returns a one-time token and approve_write executes (default false)
SECURITY_JCL_SCAN Pre-flight scan JCL before submission: IDCAMS DELETE, IEFBR14 DISP DELETE, blocked utilities (default true)
SECURITY_JCL_SCAN_STRICT Strict scan mode: WARN findings also block submissions (default false)
SECURITY_BLOCKED_PROGRAMS Comma-separated EXEC programs that may never run (extends ADRDSSU,ICKDSF,IEHINITT)
SECURITY_BLOCKED_JOB_CLASSES Comma-separated JES job classes that may never be used
SECURITY_CHANGE_TICKET_PATTERN Regex a changeTicket argument must match on writes, e.g. CHG[0-9]{6}
SECURITY_WRITE_WINDOW Allowed write window, 24h HH:MM-HH:MM (overnight ranges allowed), e.g. 08:00-18:00
SECURITY_WRITE_DAYS Weekdays writes are allowed: 0=Sun..6=Sat, e.g. 1-5
SECURITY_WRITE_WINDOW_TZ IANA timezone for the write window (default UTC)

설명은 아직 영어 원문입니다.

메뉴 이름은 2026년 11월 11일에 VS Code 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

Windsurf, Zed, Gemini CLI 같은 다른 MCP 앱은 추가 방법이 저마다 달라요. 앱 목록에서 확인하세요

MCP를 쓰는 앱 모두 보기 →

JSON 설정은 아래 “개발자용”에 있어요

막혔나요? Mainframe MCP Server을 쓰는 사람에게 물어보세요💬 토론 →

개발자용: 터미널 명령과 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-server

Claude 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 필수 env
z/OSMF hostname or IP address
ZOSMF_PORT env
z/OSMF HTTPS port (default 443)
ZOSMF_BASE_PATH env
Optional API gateway or mediation layer prefix for z/OSMF
ZOSMF_USER 필수 env
z/OS user id (required with ZOSMF_PASSWORD unless ZOSMF_TOKEN is set)
ZOSMF_PASSWORD 비밀 필수 env
Password for basic auth (required with ZOSMF_USER unless ZOSMF_TOKEN is set)
ZOSMF_TOKEN 비밀 필수 env
Auth token (alternative to user/password)
ZOSMF_TOKEN_TYPE 비밀 필수 env
Token type when using ZOSMF_TOKEN (e.g. LTPA2)
ZOSMF_REJECT_UNAUTHORIZED env
Verify TLS certificates (true in production)
ZOSMF_CERT env
PEM client certificate file path for mTLS auth
ZOSMF_CERT_KEY 비밀 필수 env
PEM client key file path for mTLS auth (required with ZOSMF_CERT)
ZOSMF_TOKEN_FILE env
Read ZOSMF_TOKEN from this file at startup (vault/agent injection)
ZOSMF_USER_ID env
End-user id for PassTicket identity propagation (RACF sees this user, not the service account)
ZOSMF_PASSTICKET_APP env
RACF PTKTDATA application name for PassTicket generation (default ZOSMF)
ZOWE_TEAM_CONFIG env
Path to a zowe.config.json to import connection settings from (env vars win)
ZOSMF_PROFILE env
Profile name inside the Zowe team config (defaults to defaults.zosmf)
LOG_LEVEL env
Log level: fatal, error, warn, info, debug, trace, silent
MCP_TRANSPORT env
Transport: stdio (IDE) or sse (legacy HTTP+SSE for container/network deployments)
MCP_SSE_PORT env
Listen port when MCP_TRANSPORT=sse
MAX_JOB_OUTPUT_LINES env
Max lines returned from a single spool DD
MAX_DATASET_READ_LINES env
Max lines returned from dataset or USS reads
MAX_JES_SPOOL_FILES env
Max spool files fetched during diagnostics
MAX_AUDIT_LINES env
Max RACF audit log lines per query
CMCI_CONTEXT 필수 env
CICSplex name or region APPLID (required for CICS tools)
CMCI_HOST env
CMCI hostname (defaults to ZOSMF_HOST)
CMCI_PORT env
CMCI HTTPS port (default 1490)
CMCI_BASE_PATH env
CMCI REST base path
DB2_LOCATION 필수 env
Db2 subsystem location name (required for Db2 tools)
DB2_HOST env
Db2 REST hostname (defaults to ZOSMF_HOST)
DB2_PORT env
Db2 REST port (default 50400)
DB2_BASE_PATH env
Db2 REST base path
SMF_SUMMARY_DATASET env
Optional SMF summary dataset for offline metrics
RMF_METRICS_ENABLED env
Query z/OSMF RMF metrics when available
RACF_AUDIT_USS_PATH env
USS path to RACF audit log file
RACF_AUDIT_DATASET env
Sequential dataset containing RACF audit records
SECURITY_READ_ONLY env
When true (default), blocks write tools such as submit_jcl
SECURITY_ALLOWED_TOOLS env
Comma-separated allowlist of MCP tool names
SECURITY_BLOCKED_TOOLS env
Comma-separated blocklist of MCP tool names
SECURITY_ALLOWED_DATASET_PATTERNS env
Comma-separated dataset patterns (e.g. USERDEV.*,SYS1.*)
SECURITY_ALLOWED_USS_PATHS env
Comma-separated USS path prefixes
SECURITY_AUDIT_LOGGING env
Log every tool invocation to stderr (SIEM-friendly JSON)
SECURITY_MAX_JCL_BYTES env
Maximum inline JCL size for submit_jcl
SECURITY_WRITE_APPROVAL env
Human-in-the-loop: submit_jcl returns a one-time token and approve_write executes (default false)
SECURITY_JCL_SCAN env
Pre-flight scan JCL before submission: IDCAMS DELETE, IEFBR14 DISP DELETE, blocked utilities (default true)
SECURITY_JCL_SCAN_STRICT env
Strict scan mode: WARN findings also block submissions (default false)
SECURITY_BLOCKED_PROGRAMS env
Comma-separated EXEC programs that may never run (extends ADRDSSU,ICKDSF,IEHINITT)
SECURITY_BLOCKED_JOB_CLASSES env
Comma-separated JES job classes that may never be used
SECURITY_CHANGE_TICKET_PATTERN env
Regex a changeTicket argument must match on writes, e.g. CHG[0-9]{6}
SECURITY_WRITE_WINDOW env
Allowed write window, 24h HH:MM-HH:MM (overnight ranges allowed), e.g. 08:00-18:00
SECURITY_WRITE_DAYS env
Weekdays writes are allowed: 0=Sun..6=Sat, e.g. 1-5
SECURITY_WRITE_WINDOW_TZ env
IANA timezone for the write window (default UTC)

설명은 아직 영어 원문입니다.

이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.

한눈에 보기

GitHub 스타 i: 0
주간 다운로드i: 62/주
라이선스 i: MIT
연결 방식: 내 컴퓨터에서 실행
전송 방식: stdio
최신 버전i: 3.0.0
카테고리i: 데이터베이스 및 데이터셋
레지스트리 공개i: 2026년 10월 25일
코드 마지막 변경i: 2026년 10월 28일
제작자: NotHarshhaa
패키지: npm: @notharshhaa/mainframe-mcp-server
저장소: NotHarshhaa/mainframe-mcp-server
레지스트리 상태: 활성

어떤 앱에서 쓸 수 있나요

이 서버의 연결 방식과 각 앱의 공식 문서를 바탕으로 했어요. 2026년 11월 10일 확인.

내 컴퓨터에서 실행하는 앱

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

모든 앱과 장단점 →

할 수 있는 일

내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 15일 점검

✓ 통과
제작자와 저장소 일치
레지스트리 이름이 GitHub 계정 NotHarshhaa 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요
✓ 통과
계속 관리되고 있음
코드 마지막 변경: 18일 전
✓ 통과
라이선스 있음
MIT 사용
– 해당 없음
엔드포인트 응답
내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요
– 해당 없음
OAuth로 로그인
내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요
… 아직 점검 안 함
도구 설명에 숨겨진 지시 없음
내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요

공개된 취약점 (OSV.dev)

OSV.dev에 @notharshhaa/mainframe-mcp-server@3.0.0 항목이 없습니다

이 버전의 패키지 자체만 확인하며 모든 의존성은 아닙니다 · 확인 2026년 11월 15일

우리가 확인하는 것 → · JSON

제작자: 재확인 요청 또는 잘못된 정보 신고

로그인

토론

질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.

아직 글이 없어요. 처음으로 질문하거나 공유해 보세요.

이곳의 글은 사용자가 쓴 것으로, PopNx 팀의 글이 아니에요.

로그인하고 글쓰기

사용자 리뷰

아직 리뷰가 없어요

로그인하고 리뷰 쓰기

데이터베이스 및 데이터셋 카테고리의 다른 서버와 비교i

이 카테고리의 다른 서버 1201개 중 0%보다 스타가 많아요
이 카테고리의 다른 서버 1201개 중 68%보다 최근에 레지스트리에 공개됐어요
기본 점검 결과가 이 카테고리의 다른 서버 1201개 중 100%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

Mainframe MCP Server, 안전한가요?

해당하는 기본 점검 3개 중 3개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

입력해야 할 값: ZOSMF_PASSWORD, ZOSMF_TOKEN, ZOSMF_TOKEN_TYPE, ZOSMF_CERT_KEY

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 18일 전 변경됐고, 최신 버전(3.0.0)은 21일 전 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Node.js도 있어야 해요.

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: QueryWeaver, Supabase, Neon, DBCode, Keboola MCP

비슷하게 동작하는 다른 것

같은 카테고리, 다른 제작자, 명령 확인 완료. 공식이 먼저, 그다음 스타 순.

카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

QueryWeaver

An MCP server for Text2SQL: transforms natural language into SQL using graph schema understanding.

제작자: FalkorDB성장 중★ 1.1천14개월 전 업데이트

내 컴퓨터에서 실행✓ falkordb.com

설치

Supabase

MCP server for interacting with the Supabase platform

제작자: supabase널리 사용됨↓ 24.6만/주★ 3천 저장소 전체의 별그저께 업데이트

컴퓨터 또는 클라우드✓ 서비스 회사 · supabase.com

설치

Neon

Official Neon MCP server for managing Neon projects and Lakebase Postgres databases.

제작자: neondatabase성장 중★ 6639일 전 업데이트

클라우드에서 실행✓ 서비스 회사 · neon.com

연결 방법

DBCode

Query and explore 100+ databases through your DBCode connections.

제작자: dbcodeio초기↓ 80/주★ 367 저장소 전체의 별43일 전 업데이트

내 컴퓨터에서 실행✓ 서비스 회사 · dbcode.io

설치

Keboola MCP

Connect your AI assistants to Keboola and expose your data, transformations, SQL queries, ...

제작자: keboola성장 중↓ 1.4천/주★ 854일 전 업데이트

컴퓨터 또는 클라우드✓ 서비스 회사 · keboola.com

설치

QueryWeaver — 컴퓨터에 설치 필요 · 키 불필요
Supabase — 클라우드 또는 컴퓨터 설치 모두 가능 · 키 필요 · Claude 디렉터리에 있음
Neon — 클라우드에서 동작, 설치 불필요 · 키 불필요
DBCode — 컴퓨터에 설치 필요 · 키 불필요
Keboola MCP — 클라우드 또는 컴퓨터 설치 모두 가능 · 키 불필요

제작자의 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.

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); optionally CMCI_HOST, CMCI_PORT (default 1490), CMCI_BASE_PATH (default /CICSSystemManagement).
The service account needs RACF/SAF authority to the CMCI data sets (XCSDATA/CICSPLEX resource 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 (default 50400, 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 against SYSIBM.SYSTABLES with 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

앞부분만 보여 드려요. 나머지는 저장소에서 읽어 보세요

Mainframe MCP Server

What it does

설치

Node.js 설치 (아직 없다면)