| Name | zos-ftp-mcp JSON |
| Version |
0.1.0
JSON |
| download |
| home_page | None |
| Summary | MCP server for z/OS mainframe FTP operations |
| upload_time | 2025-09-02 22:13:29 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.8 |
| license | MIT |
| keywords |
mainframe
zos
ftp
mcp
dataset
pds
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# z/OS FTP MCP Server
[](https://pypi.org/project/zos-ftp-mcp/)
[](https://pypi.org/project/zos-ftp-mcp/)
[](https://opensource.org/licenses/MIT)
A Model Context Protocol (MCP) server for interacting with z/OS mainframe systems via FTP.
## Features
- List datasets from mainframe catalog with pattern matching
- Download datasets in binary format
- Download members from partitioned datasets (PDS)
- Connection management via environment variables
## Installation
### For MCP Server Usage
No installation needed! The MCP configuration with `uvx` will automatically download and run the package.
### For Python Library Usage
```bash
pip install zos-ftp-mcp
```
## Configuration
Set environment variables for connection:
```bash
export ZFTP_HOST="your-mainframe-host"
export ZFTP_PORT="21"
export ZFTP_USER="your-username"
export ZFTP_PASSWORD="your-password"
export ZFTP_TIMEOUT="30.0"
export ZFTP_DOWNLOAD_PATH="/path/to/downloads"
```
## Usage
### As MCP Server
```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"
}
}
}
}
```
### Direct Command Line
```bash
zos-ftp-mcp
```
## Tools Available
- `list_catalog(pattern)` - List datasets matching pattern
- `download_binary(source_dataset, target_file)` - Download dataset
- `download_pds_members(dataset, target_dir, members, retr_mode, ftp_threads, batch_size)` - Download PDS members
- `get_connection_info()` - Show current connection settings
- `set_connection_params(...)` - Update connection parameters
## Sample Usage Prompts
Once configured, you can use these prompts:
### Dataset Discovery
"List all datasets starting with SYS1 to explore system datasets"
"Show me all user datasets matching MYUSER.* pattern"
### Data Download
"Download the dataset MYUSER.COBOL.SOURCE to my local downloads folder"
"Download all members from the PDS MYUSER.COBOL.COPYLIB to a local directory"
### Connection Management
"Show me the current FTP connection settings"
"Update the download path to /Users/myname/mainframe-data"
## Dependencies
- [zosftplib](https://pypi.org/project/zosftplib/) - z/OS FTP operations
- [mcp](https://pypi.org/project/mcp/) - Model Context Protocol
## License
MIT License - see LICENSE file for details.
Raw data
{
"_id": null,
"home_page": null,
"name": "zos-ftp-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "mainframe, zos, ftp, mcp, dataset, pds",
"author": null,
"author_email": "Arunkumar Selvam <aruninfy123@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/75/9b/e84b564f31cc1f64d4c8dccf3decb934802a7a25896795629044a5be4f66/zos_ftp_mcp-0.1.0.tar.gz",
"platform": null,
"description": "# z/OS FTP MCP Server\n\n[](https://pypi.org/project/zos-ftp-mcp/)\n[](https://pypi.org/project/zos-ftp-mcp/)\n[](https://opensource.org/licenses/MIT)\n\nA Model Context Protocol (MCP) server for interacting with z/OS mainframe systems via FTP.\n\n## Features\n\n- List datasets from mainframe catalog with pattern matching\n- Download datasets in binary format\n- Download members from partitioned datasets (PDS)\n- Connection management via environment variables\n\n## Installation\n\n### For MCP Server Usage\nNo installation needed! The MCP configuration with `uvx` will automatically download and run the package.\n\n### For Python Library Usage\n```bash\npip install zos-ftp-mcp\n```\n\n## Configuration\n\nSet environment variables for connection:\n\n```bash\nexport ZFTP_HOST=\"your-mainframe-host\"\nexport ZFTP_PORT=\"21\"\nexport ZFTP_USER=\"your-username\"\nexport ZFTP_PASSWORD=\"your-password\"\nexport ZFTP_TIMEOUT=\"30.0\"\nexport ZFTP_DOWNLOAD_PATH=\"/path/to/downloads\"\n```\n\n## Usage\n\n### As MCP Server\n\n```json\n{\n \"mcpServers\": {\n \"zos-ftp-mcp\": {\n \"command\": \"uvx\",\n \"args\": [\"zos-ftp-mcp\"],\n \"env\": {\n \"ZFTP_HOST\": \"your-mainframe-host\",\n \"ZFTP_USER\": \"your-username\",\n \"ZFTP_PASSWORD\": \"your-password\",\n \"ZFTP_DOWNLOAD_PATH\": \"/path/to/downloads\"\n }\n }\n }\n}\n```\n\n### Direct Command Line\n```bash\nzos-ftp-mcp\n```\n\n## Tools Available\n\n- `list_catalog(pattern)` - List datasets matching pattern\n- `download_binary(source_dataset, target_file)` - Download dataset\n- `download_pds_members(dataset, target_dir, members, retr_mode, ftp_threads, batch_size)` - Download PDS members\n- `get_connection_info()` - Show current connection settings\n- `set_connection_params(...)` - Update connection parameters\n\n## Sample Usage Prompts\n\nOnce configured, you can use these prompts:\n\n### Dataset Discovery\n\"List all datasets starting with SYS1 to explore system datasets\"\n\n\"Show me all user datasets matching MYUSER.* pattern\"\n\n### Data Download\n\"Download the dataset MYUSER.COBOL.SOURCE to my local downloads folder\"\n\n\"Download all members from the PDS MYUSER.COBOL.COPYLIB to a local directory\"\n\n### Connection Management\n\"Show me the current FTP connection settings\"\n\n\"Update the download path to /Users/myname/mainframe-data\"\n\n## Dependencies\n\n- [zosftplib](https://pypi.org/project/zosftplib/) - z/OS FTP operations\n- [mcp](https://pypi.org/project/mcp/) - Model Context Protocol\n\n## License\n\nMIT License - see LICENSE file for details.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "MCP server for z/OS mainframe FTP operations",
"version": "0.1.0",
"project_urls": {
"Bug Reports": "https://github.com/arunkumars-mf/zos-ftp-mcp/issues",
"Homepage": "https://github.com/arunkumars-mf/zos-ftp-mcp",
"Source": "https://github.com/arunkumars-mf/zos-ftp-mcp"
},
"split_keywords": [
"mainframe",
" zos",
" ftp",
" mcp",
" dataset",
" pds"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ccb3383d9d4dcd4fff656a147503aa5d191777348394bf64c2a2ba329c93ad74",
"md5": "0e52f23a880d6390753c1b50eac69ff8",
"sha256": "fce0c02ea566f5becc0e21bd999b91ec849fc7d8e6f494ed77c13f2cef990d03"
},
"downloads": -1,
"filename": "zos_ftp_mcp-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0e52f23a880d6390753c1b50eac69ff8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 6261,
"upload_time": "2025-09-02T22:13:28",
"upload_time_iso_8601": "2025-09-02T22:13:28.739417Z",
"url": "https://files.pythonhosted.org/packages/cc/b3/383d9d4dcd4fff656a147503aa5d191777348394bf64c2a2ba329c93ad74/zos_ftp_mcp-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "759be84b564f31cc1f64d4c8dccf3decb934802a7a25896795629044a5be4f66",
"md5": "1931942411648686872d554d9ef17d95",
"sha256": "8dfff57c9f8fcd754ea6199b261c572698ea7a2f2e1136613cf953426da34ced"
},
"downloads": -1,
"filename": "zos_ftp_mcp-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "1931942411648686872d554d9ef17d95",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 5561,
"upload_time": "2025-09-02T22:13:29",
"upload_time_iso_8601": "2025-09-02T22:13:29.722469Z",
"url": "https://files.pythonhosted.org/packages/75/9b/e84b564f31cc1f64d4c8dccf3decb934802a7a25896795629044a5be4f66/zos_ftp_mcp-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-02 22:13:29",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "arunkumars-mf",
"github_project": "zos-ftp-mcp",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "zos-ftp-mcp"
}
