内容
IBM 5250 MCP 服务器 — 时间有限测试版
提供 IBM i (AS/400) 5250 终端模拟的模型上下文协议（MCP）服务器，支持 EBCDIC DBCS（日语），可从 Claude 等 MCP 客户端使用。
> 日本語版は [`README_ja.md`](README_ja.md) を参照してください。
---
## ⚠️ 重要信息
- **这是时间有限的版本，仅在 2026-07-31 前有效。** 从 2026-08-01 起，启动和连接将被自动拒绝。请获取更新版本以继续使用。
- **支持平台：仅限 Windows (x64)。**
- **不提供 macOS 版本**，由于 bun 构建工具的交叉编译错误（[oven-sh/bun#25346](https://github.com/oven-sh/bun/issues/25346导致无法从 Windows 生成可工作的 macOS 可执行文件。
- **验证环境：本产品仅在日语环境（主要语言 2962，QCCSID 65535）下验证通过。** 在其他语言 / CCSID 环境下的运行不受保证。
---
## ⚠️ 免责声明
- 这是一个 **实验性 5250 模拟器实现**；**不** 旨在替代生产环境中使用的现有 5250 模拟器。
- 数据传输、控制台连接和多语言支持（包括从右到左 / RTL 语言）等功能 **未** 实现。
- 由于可以直接操作 5250 屏幕，**AI 执行破坏性操作的可能性并非为零。**
- **测试不足，且不提供支持。请自担风险。**
- 该项目作为 **个人项目** 开发，不代表任何特定组织或实体的意图。
---
## 概述
- TN5250E 协议 / EBCDIC DBCS（cp1399、cp5026、cp037 等）/ 24x80（DS3）和 27x132（DS4）
- 基于 Web 的屏幕查看器（默认 `http://localhost:5250`）
- 单个独立可执行文件（运行时捆绑）。无需安装 Node.js。
## 下载
从此存储库的 [**Releases**](https://github.com/GuriCat/ibm5250-mcp/releases) 页面下载 `ibm5250-mcp-windows-x64.exe`。
## 快速入门
1. 将 `ibm5250-mcp-windows-x64.exe` 放在任意文件夹中。
2. **将 `config.json` 放在同一文件夹中**（包含您的 IBM i 连接预设）。服务器会自动读取 `config.json`、预设和日志，**无论启动工作目录为何**（因此您无需在 MCP 客户端设置工作目录）。
3. 在您的 MCP 客户端（例如 Claude Desktop）中注册：
```json
{
"mcpServers": {
"ibm5250": {
"command": "C:\\path\\to\\ibm5250-mcp-windows-x64.exe"
}
}
}
```
`config.json` 示例：
```json
{
"presets": {
"MYSYS": {
"host": "ibm-i.example.com",
"port": 23,
"code_page": "cp1399",
"screen_size": "27x132",
"allow_ds4": true
}
}
}
```
4. 使用 `{"preset": "MYSYS"}` 调用 `connect_5250` 工具连接到主机。在 `http://localhost:5250` 打开屏幕查看器。
详见随附的文档。
## 文档
位于 `docs/manuals/` 下：
- English: `IBM5250-MCP-User-Guide-EN.pdf`, `IBM5250-MCP-Admin-Guide-EN.pdf`
- 中文（简体）: `IBM5250-MCP-User-Guide.pdf`, `IBM5250-MCP-Admin-Guide.pdf`
## 更新日志
在 [`CHANGELOG.md`](CHANGELOG.md) 中查看此版本的面向用户更改。
## 适用于 AI 代理
如果您从 AI 代理（LLM，如 Claude）驱动此服务器，请阅读 [`AI-GUIDE.md`](AI-GUIDE.md)。
PDF 文档是为人类编写的（截图、安装、配置）。`AI-GUIDE.md` 是 **针对 AI 代理的密集、结构化指南**：它解释了通过 MCP 公开并嵌入可执行文件中的完整工具架构（**因此不需要源代码**），以及 AI 代理必须了解的 5250 概念（OIA、`X II` 键盘锁定、DS3/DS4、字段和属性字节偏移一、AID 与编辑键、DBCS/SO-SI）、典型的连接 → 读取（`get_screen` json）→ 输入（`send_text`）流程、登录示例、常见操作模式和常见陷阱。阅读它可以让 AI 代理在无需检查任何源代码的情况下可靠地操作 IBM i。
## 许可证
使用此软件须遵守最终用户许可协议（[`EULA.md`](EULA.md)）。**源代码未公开。** 禁止反向工程、反编译、修改和重新分发。
第三方致谢：请参阅 [`THIRD-PARTY-NOTICES.md`](THIRD-PARTY-NOTICES.md)。
