MCP For I

MCP-for-i

mcp-for-i 是IBM i工作流的本地MCP服务器+控制平面。它为代理驱动的操作提供了安全的连接入职、密钥链支持的凭据、跨平台运行时更新控制和IBM i工具。

安装

从npm全局安装：

npm i -g mcp-for-i

验证命令：

mcp-for-i --help
mcp-for-i-control help

支持的shell和终端包括PowerShell， cmd，跨Windows、macOS和Linux的Git Bash、Bash、Zsh和WSL shell。

快速开始

1. 打开本地控制平面：

mcp-for-i control

mcp-for-i control 如果需要，将在后台启动控制服务器，然后打开UI。如果浏览器无法在当前环境中打开，它会打印本地URL。

1. 默认的本地UI URL为：

http://127.0.0.1:3980

1. 在UI中添加IBM i连接配置文件。密码存储在操作系统钥匙链中，而不是普通配置中。

控制命令

从npm安装或git checkout构建中，这些命令是支持的控制入口点：

mcp-for-i control
mcp-for-i control status
mcp-for-i control enable
mcp-for-i control disable

等效直接控制平面二进制命令：

mcp-for-i-control open
mcp-for-i-control status
mcp-for-i-control enable
mcp-for-i-control disable
mcp-for-i-control serve

环境行为：

• 窗户： enable 注册启动条目。
• macOS： enable 注册LaunchAgent。
• Linux： enable 使用用户 systemd 服务可用时。
• WSL： enable 安装防护 .bashrc 钩子，在交互式Bash shell启动时启动控制平面。

添加到编码客户端

控制平面UI现在包括 Clients 一键设置选项卡，用于：

• Codex Desktop / CLI
• Claude Code 当 claude CLI已安装
• VS Code / GitHub Copilot 当 code CLI已安装

它还包括以下手动指南：

• Project Bob
• 其他使用通用JSON/TOML stdio服务器配置的MCP客户端

UI在运行控制平面的同一台机器上写入或调用本地客户端特定的设置。如果未安装客户端CLI，UI将返回显示要手动使用的确切启动命令/代码段。

更新和版本管理

全球最新更新：

npm i -g mcp-for-i@latest

安装特定版本：

npm i -g mcp-for-i@0.1.1

回滚示例：

npm i -g mcp-for-i@0.1.0

检查当前安装的版本：

mcp-for-i --version

控制平面更新

控制平面故意保持狭窄：

• Update MCP

- 如果从git checkout运行：从中提取最新更改 origin/，然后安装/构建。 - 如果作为npm安装包运行：将全局npm包升级到最新版本。 - 在Windows全局安装中，更新仍在分离的更新程序中运行，以避免文件锁定(EBUSY)自我更新时出错。

• Update Skills

- 提取或克隆配置的技能库，并分支到本地 skills 目录。

对于npm安装和手动升级，首选标准npm命令，如 npm i -g mcp-for-i@latest.

开发（Git Checkout）

对于从源代码工作的贡献者：

npm install
npm run build
npm test
npm run start:controlplane

您还可以在构建后直接使用构建的工件：

node dist/index.js
node dist/index.js control
node dist/controlplane/index.js open

自动释放（无手动版本颠簸）

使用发布脚本而不是原始脚本 npm publish.

补丁发布：

npm run release:patch

小版本发布：

npm run release:minor

主要发布：

npm run release:major

它的作用：

• 验证git工作树是否干净。
• 跑 npm test （除非 --skip-tests 通过）。
• 检查npm发布的版本。
• 仅当本地版本不在前面时，才会自动调整版本。
• 发布到npm。
• 将commit/tag推送到GitHub。

可选标志：

npm run release:patch -- --skip-tests
npm run release:patch -- --otp=123456
npm run release:patch -- --no-push

安全模型

• 带有直接工具参数的凭据被阻止用于连接创建/更新流。
• 密码在可用时存储在钥匙链中。
• 控制平面为本地优先(127.0.0.1 默认情况下）。
• 保护策略配置文件是操作安全的默认配置文件。
• 工具模式是严格的(additionalProperties: false)使用运行时参数验证，包括嵌套连接/动作/过滤器/配置文件有效载荷。
• QSYS对象名称和源设置在命令执行之前进行验证，以降低插值和注入风险。

链接

• 主回购： ashishthomas2202/mcp-for-i
• 技能库： ashishthomas2202/mcp-for-i-skills
• 文件： docs/
• 完整功能指南： docs/capabilities.md