Zos Ftp MCP

MCP运维云端

提供方 arunkumars-mf

运维云端 stdio · 本地进程 无需鉴权 社区 / 第三方
查看接入方式

一个通过FTP与z/OS大型机系统交互的模型上下文协议(MCP)服务器,支持数据集列表、下载、JCL作业提交和监控等功能。

一句话选型结论

按资料字段整理

Zos Ftp MCP 属于运维云端类 MCP 服务器,stdio · 本地进程,无需鉴权,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 12 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量12暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

大型机交互Python本地部署FTP服务器数据集管理JCL作业处理编码转换

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
pip install zos-ftp-mcp

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 12 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 12 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Zos Ftp MCP当前 12 stdio · 本地进程 本地部署 有 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方arunkumars-mf上游标注的维护方 arunkumars-mf
分类运维云端本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

7.1 KB
来自项目仓库与上游目录的原文,未做删改

z/OS FTP MCP服务器

用于通过FTP与z/OS大型机系统交互的模型上下文协议(MCP)服务器。

特性

  • 使用模式匹配从大型机目录中列出数据集
  • 下载二进制和文本格式的数据集,并进行编码转换
  • 从具有并行支持的分区数据集(PDS)下载成员
  • 提交并监控JCL作业
  • 高级文本处理:编码转换、行尾控制、尾随空格处理
  • 可配置的写保护,安全生产使用
  • 通过环境变量进行连接管理

安装

MCP服务器使用情况

无需安装!MCP配置 uvx 将自动下载并运行该包。

Python库用法```bash

pip install zos-ftp-mcp


## 配置

设置连接的环境变量:```bash
export ZFTP_HOST="your-mainframe-host"
export ZFTP_PORT="21"
export ZFTP_USER="your-username"
export ZFTP_PASSWORD="your-password"
export ZFTP_TIMEOUT="600.0"
export ZFTP_DOWNLOAD_PATH="/path/to/downloads"
export ZFTP_DEBUG="false"  # Set to "true" for detailed FTP protocol logging
export ZFTP_ALLOW_WRITE="false"  # Set to "true" to enable upload/submit operations

高级文本处理

控制文本文件如何从EBCDIC主机下载到ASCII/UTF-8:```bash

Character encoding conversion (EBCDIC to ASCII/UTF-8)

export ZFTP_DEFAULT_ENCODING="IBM-037,UTF-8" # US/Canada EBCDIC to UTF-8

Other options: IBM-1047,UTF-8 (Latin-1), IBM-285,UTF-8 (UK)

Line ending format

export ZFTP_DEFAULT_LINE_ENDING="LF" # Unix/Linux style

Options: CRLF (Windows), LF (Unix), CR (old Mac), NONE

Preserve trailing spaces in fixed-length records

export ZFTP_PRESERVE_TRAILING_SPACES="false" # Strip trailing spaces

Set to "true" to keep 80-character fixed-length records intact


**何时使用这些设置:**

- **编码**:对于正确的字符转换(JCL、COBOL、日志)至关重要
- **行尾**:跨平台兼容性、版本控制(Git)
- **尾部空格**:对于大多数文本文件保持“false”,对于固定格式数据保持“true”

### 写入操作

默认情况下,MCP服务器为 **只读** 为了安全。要启用写入操作,请执行以下操作:```bash
export ZFTP_ALLOW_WRITE="true"

启用后,您可以:

  • 将文件上传到大型机数据集(upload_dataset)
  • 提交JCL作业(submit_job)

在生产环境中小心使用。只读操作(列表、下载、监视作业)始终可用。

用法

作为MCP服务器```json

{
"mcpServers": {
"zos-ftp-mcp": {
"command": "uvx",
"args": ["zos-ftp-mcp"],
"env": {
"ZFTP_HOST": "your-mainframe-host",
"ZFTP_USER": "your-username",
"ZFTP_PASSWORD": "your-password",
"ZFTP_DOWNLOAD_PATH": "/path/to/downloads"
}
}
}
}


### 直接命令行```bash
zos-ftp-mcp

可用工具

数据集操作

  • list_catalog(pattern, limit, offset) -列出与分页模式匹配的数据集
  • download_binary(source_dataset, target_file) -以二进制模式下载数据集
  • download_text(source_dataset, target_file, encoding, line_ending, preserve_trailing_spaces) -带文本处理的下载
  • download_pds_members(dataset, target_dir, members, encoding, line_ending, ...) -使用高级选项下载PDS成员
  • upload_dataset(source_file, target_dataset, binary, lrecl, blksize, recfm, space) -将文件上传到数据集(要求ZFTP_ALLOW_WRITE=true)
  • get_vsam_info(dataset, limit, offset) -通过分页获取VSAM数据集信息(要求ZFTP_ALLOW_WRITE=true)
  • get_gdg_info(gdg_base, limit, offset) -通过分页获取GDG基本属性和生成(需要ZFTP_ALLOW_WRITE=true)

作业操作

  • submit_job(jcl, jobname) -提交JCL作业(要求ZFTP_ALLOW_WRITE=true)
  • list_jes_jobs(jobmask, owner, status, limit, offset) -列出具有筛选和分页功能的作业
  • get_job_info(jobid) -获取作业详细信息
  • download_job_spool(jobid, target_file) -下载带有返回代码提取的作业输出

连接管理

  • get_connection_info() -显示当前连接设置

示例使用提示

配置后,您可以使用以下提示:

数据集发现

“列出从SYS1开始的所有数据集以探索系统数据集”

“显示与MYUSER.*模式匹配的所有用户数据集”

数据下载

“使用UTF-8编码将数据集MYUSER.COBOL.SOURCE下载到我的本地下载文件夹”

“将PDS MYUSER.COBOL.COPYLIB中的所有成员下载到本地目录”

数据上传(要求ZFTP_ALLOW_WRITE=true)

“将我的本地文件test.jcl上传到数据集MYUSER.jcl.test,lrecl=80,recfm=FB”

“将本地文件member.cbl上载到PDS成员MYUSER.COBOL.SOURCE(TESTPGM)”

作业操作

“提交此JCL作业并等待完成”(要求ZFTP_ALLOW_WRITE=true)

“列出我所有处于输出状态的作业”

“下载作业JOB12345的线轴输出,并向我显示返回代码”

连接管理

“显示当前FTP连接设置”

依赖项

  • 主控程序 -模型上下文协议
  • Python 3.10+标准库(ftplib、pathlib等)

高级功能

分页支持

为了避免大结果集的上下文窗口过多,有几个工具支持分页:

带分页的工具:

  • list_catalog -通过数据集进行分页
  • list_jes_jobs -通过工作进行分页
  • get_vsam_info -通过VSAM数据集进行分页
  • get_gdg_info -通过GDG世代传诵

用途:```python

Get first 50 datasets

list_catalog('USER.*', limit=50)

Get next 50 datasets

list_catalog('USER.*', limit=50, offset=50)

Get first 20 jobs

list_jes_jobs(status='OUTPUT', limit=20)

Get first 10 GDG generations

get_gdg_info('AWS.M2.CARDDEMO.TRANSACT.BKUP', limit=10)


**答复包括:**

- `count` -此页面中返回的项目数
- `total` -可用项目总数
- `offset` -当前偏移量
- `has_more` -如果有更多项目可用,则为True

### JESINTERFACE级别限制

服务器会自动检测大型机的JES接口级别。随着 **jesinterfaceelevel=1** (常见于旧系统):

**职位提交:**

- JCL中的作业名必须为 `userid + exactly one character`
- 示例:如果用户ID为 `USER123`,作业名称必须为 `USER123J`
- 服务器会自动验证并提供明确的错误消息

**职位列表:**

- 服务器端过滤可能不起作用
- 客户端过滤是自动应用的
- 作业可能会很快从卷轴中清除

**解决方法:** 服务器透明地处理这些限制。请注意,如果作业被快速清除,则作业检索可能会失败。

### 并行PDS下载

使用多个FTP连接更快地下载PDS成员:```python
# Sequential (default)
download_pds_members(dataset, target_dir, members, ftp_threads=1)

# Parallel (2-16 threads)
download_pds_members(dataset, target_dir, members, ftp_threads=4)

对于大型PDS(>10个成员),并行下载速度要快得多。

每次操作超限

虽然默认值是通过环境变量设置的,但您可以在每次操作中覆盖它们:```python

Use different line ending for specific file

download_text(dataset, target_file, line_ending='CRLF')

Preserve trailing spaces for fixed-format data

download_text(dataset, target_file, preserve_trailing_spaces=True)

Use different encoding

download_pds_members(dataset, target_dir, members, encoding='IBM-1047,UTF-8')
```

许可证

MIT许可证-有关详细信息,请参阅许可证文件。

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Zos Ftp MCP 怎么安装?

在客户端按下面的安装命令接入:pip install zos-ftp-mcp。装完在客户端配置里引用同一个包或端点。

Zos Ftp MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Zos Ftp MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Zos Ftp MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Zos Ftp MCP 能提供哪些能力?

资料显示约 12 个工具;能力标签包括 Python、云端部署、Docker。具体工具清单以官方文档为准。

Zos Ftp MCP 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Zos Ftp MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。