IBM i MCP Server

官方

面向 IBM i 系统的 MCP 服务器，提供基于 SQL 的安全访问。

分类: 数据库第 54 / 58
Stars: ★ 85 热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js 18+ · Docker
凭据: 需要 API Key / 凭据
许可证: Apache-2.0
最近提交: 4 天前
工具数: 1

42FMRS · D

IBM i MCP 服务器为 IBM i 系统提供结构化、安全的 SQL 访问，通过 Mapepire 实现，适合需要与 Db2 for i 交互的 AI 代理。官方维护，但需要 Mapepire 前提条件。凭借 YAML 工具定义和 CLI 伴生，它对 AI 和终端用户都很灵活。适合需要现代、低延迟数据库访问的基于 IBM i 的 AI 工作负载。

最强项 · 文档质量 13/20 最弱项 · 可靠性 5/20

可靠性

5/20

安全与权限

6/20

维护活跃度

7/20

文档质量

13/20

安装易用性

11/20

查看各项评分依据

可靠性 5/20: 仅有 README 提供的启动命令和架构描述，未见 package.json、CI 工作流或测试；无法确认 init/tools-list 握手和工具实际行为，错误处理未知。按静态校准上限原则，给 5 分。
安全与权限 6/20: README 显示通过 .env 存放 DB2i_PASS，且示例含 DB2i_IGNORE_UNAUTHORIZED=true；YAML 工具可执行任意 SQL，未看到最小权限、危险操作确认或数据流披露。未发现恶意代码/真实令牌，因此未触发红色底线，给 6 分。
维护活跃度 7/20: 仓库未归档、有 Apache-2.0 许可证和公开 issue，但所供材料没有提交记录、发布历史、依赖更新或安全响应渠道，维护治理证据不足，给 7 分。
文档质量 13/20: README 覆盖面广：快速开始、环境变量、YAML 工具示例、Docker、Python 客户端、部署和 Mapepire 准备，并有外部文档链接。但缺少故障排查、限制/成本、完整参数模式及主流客户端配置示例，给 13 分。
安装易用性 11/20: 安装步骤清楚（npx/Docker、.env、healthz 验证），并附 Python 客户端示例；但依赖外部 Mapepire 服务，未提供主流客户端（如 Claude Desktop）的配置 JSON，且无 CI/测试佐证，给 11 分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么连接数据库

适合谁

在 IBM i 环境中构建 AI 代理或 AI 驱动的应用程序。
需要通过 MCP 协议（stdio 或 HTTP）进行远程服务器支持。
利用 Mapepire 快速、轻量级、低延迟的数据库访问。
希望使用 YAML 定义自定义 SQL 工具。

不适合谁

不需要 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 性能。

安装接入

准备工作

运行环境：Node.js 18+ · Docker

其他可选配置项（1 个）

MCP_SERVER_CONFIG 可选 Docker 部署时指向 .env 配置文件的路径。

在 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。

验证是否装好

启动服务器后运行 curl http://localhost:3010/healthz 确认健康检查通过，并在客户端工具列表中确认出现 system_status 工具。

常见排障

检查 Mapepire 是否运行在端口 8076，并确保防火墙允许入站连接。
验证 `.env` 文件中的主机、用户、密码、端口设置是否正确。
确保使用 Node.js 18 或更高版本。
如果使用 Docker，请确保正确挂载工具目录和 `.env` 文件。
使用 `curl http://localhost:3010/healthz` 检查服务器健康。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

显示 IBM i 系统的整体状态，包括 CPU、内存和 I/O 指标
查看当前系统性能统计信息
调用 system_status 工具检查系统健康情况

工具能力 1

system_status 只读

整体系统性能统计，包括 CPU、内存和 I/O 指标。

使用场景

系统监控：实时性能分析和健康检查。

故障排除：使用自然语言查询诊断问题。

报告：生成系统报告和见解。

自动化：通过对话执行管理任务。

支持客户端

Claude Desktop

VSCode Copilot

Bob

依据项目文档列出，未经本站实测。

详细介绍

IBM i MCP 服务器使 AI 代理能够通过模型上下文协议（MCP）与 IBM i 系统交互。它通过 Mapepire 提供对 Db2 for i 数据库的安全、基于 SQL 的访问，允许 AI 应用程序（如 Claude、VSCode Copilot、Bob 和自定义代理）查询系统信息、监控性能并执行数据库操作。该仓库还提供了 ibmi CLI，与 MCP 服务器共享相同的 YAML 驱动 SQL 工具引擎，因此相同的工具定义在 MCP 服务器和 CLI 中均可使用。