适合谁
- 在 IBM i 环境中构建 AI 代理或 AI 驱动的应用程序。
- 需要通过 MCP 协议（stdio 或 HTTP）进行远程服务器支持。
- 利用 Mapepire 快速、轻量级、低延迟的数据库访问。
- 希望使用 YAML 定义自定义 SQL 工具。
I
42FMRS · D
IBM i MCP 服务器为 IBM i 系统提供结构化、安全的 SQL 访问，通过 Mapepire 实现，适合需要与 Db2 for i 交互的 AI 代理。官方维护，但需要 Mapepire 前提条件。凭借 YAML 工具定义和 CLI 伴生，它对 AI 和终端用户都很灵活。适合需要现代、低延迟数据库访问的基于 IBM i 的 AI 工作负载。
IBM i MCP 服务器使 AI 代理能够通过模型上下文协议（MCP）与 IBM i 系统交互。它通过 Mapepire 提供对 Db2 for i 数据库的安全、基于 SQL 的访问，允许 AI 应用程序（如 Claude、VSCode Copilot、Bob 和自定义代理）查询系统信息、监控性能并执行数据库操作。该仓库还提供了 ibmi CLI，与 MCP 服务器共享相同的 YAML 驱动 SQL 工具引擎，因此相同的工具定义在 MCP 服务器和 CLI 中均可使用。
工具能力
system_status
整体系统性能统计，包括 CPU、内存和 I/O 指标。
安装接入
在 IBM i 系统上安装并配置 Mapepire（默认端口 8076）。
克隆仓库：git clone https://github.com/IBM/ibmi-mcp-server.git 并进入目录。
配置 .env 文件，设置 DB2i_HOST、DB2i_USER、DB2i_PASS、DB2i_PORT（默认 8076）和 DB2i_IGNORE_UNAUTHORIZED。
使用 npx -y @ibm/ibmi-mcp-server@latest --transport http --tools ./tools/performance/performance.yaml 启动服务器。
验证服务器健康：curl http://localhost:3010/healthz。
选型与风险
不适合谁
- 不需要 MCP 客户端的终端优先交互，此时应使用 `ibmi` CLI。
- 不使用 Mapepire 的 IBM i 系统。
- 需要传统 ODBC/JDBC 数据库访问方式的场景。
- 无需 AI 或 MCP 集成的简单 SQL 查询工具。
所需权限
- 需要 IBM i 系统的凭据（用户名和密码）进行数据库访问。
- 需要 Mapepire 服务器在 IBM i 上运行，默认端口 8076。
- 可能需要网络访问 IBM i 系统上的指定端口。
- 对于示例工具，需要访问 QSYS2 系统视图和表。
风险与副作用
- 凭据管理：直接传递密码可能有安全风险；建议使用环境变量或安全存储。
- 网络攻击面：通过 HTTP 暴露 MCP 服务器可能引发未授权访问，除非采取适当措施（如 HTTPS、认证）。
- 数据泄露：SQL 工具可能访问敏感数据；必须限制工具范围。
- 资源消耗：长时间运行的查询可能影响 IBM i 性能。
常见排障
- 检查 Mapepire 是否运行在端口 8076，并确保防火墙允许入站连接。
- 验证 `.env` 文件中的主机、用户、密码、端口设置是否正确。
- 确保使用 Node.js 18 或更高版本。
- 如果使用 Docker，请确保正确挂载工具目录和 `.env` 文件。
- 使用 `curl http://localhost:3010/healthz` 检查服务器健康。
使用场景
系统监控：实时性能分析和健康检查。
故障排除：使用自然语言查询诊断问题。
报告：生成系统报告和见解。
自动化：通过对话执行管理任务。
支持客户端
Claude Desktop完整支持
VSCode Copilot完整支持
Bob完整支持