本地 stdio 与工作区文件
用 i2v.ai CLI 启动本地 MCP 服务,并按需访问项目文件。
安装并检查 CLI
使用 Node.js 20 或以上版本。下载 CLI,或安装 i2v-models Skill 并使用它附带的脚本。给启动 MCP 进程的环境设置有效的 I2V_API_KEY。
node /absolute/path/i2v-cli.mjs doctor --json配置客户端
对于支持 mcpServers JSON 的客户端,添加以下条目。若客户端使用其他格式,将启动命令设为 node,并将脚本绝对路径和 mcp 分别作为两个参数。
{
"mcpServers": {
"i2v": {
"command": "node",
"args": ["/absolute/path/i2v-cli.mjs", "mcp"]
}
}
}通过客户端的密钥设置或进程环境提供 I2V_API_KEY。从桌面启动时,可能需要填写 Node 可执行文件的绝对路径。改完配置后重启或重载客户端。
上传与保存本地文件
把 I2V_WORKSPACE_DIR 指向已有项目目录,即可使用 upload_file 和 download_task。CLI 会将文件操作限制在该目录。上传指定的参考文件,使用经过验证的地址作为生成入参。要保存已有结果,提供原任务 ID 和工作区内的输出路径。完整流程见。
验证、更新与断开
调用 get_account 或 list_models。客户端找不到工具时,确认 Node 能在相同环境中启动该脚本。本地 stdio 通过托管的 i2v.ai MCP 调用远程工具,并在初始化时检查发布版本。使用 doctor 查看详情,更换脚本后重启客户端。移除本地配置即可断开,需要让密钥失效时再停用或轮换对应的 API Key。

