my-custom-mcp 工具说明

MCP 服务器 基于 opencode zen 网关（https://opencode.ai/zen/go/v1）minimax-m3 多模态模型的图像理解工具，让 zcode / Codex CLI 中的纯文本模型（如 DeepSeek）也能看懂图片。需要一个 opencode.ai 账号和 API Key，支持 zcode 与 Codex CLI 两种接入方式。

功能

工具说明
understand_image(image_source, prompt) 分析一张图片并返回文字描述。
image_source 自动识别三种形式：
① 网络图片 URL（http:// 或 https://）
② base64 图片数据（可带 data:image/xxx;base64, 前缀）
③ 本机图片文件绝对路径

第一步：获取 OpenCode API Key

  1. 打开 opencode.ai 并登录
  2. 进入 OpenCode Zen 控制台，绑定计费方式（minimax-m3 按量计费）
  3. 创建并复制你的 API Key

第二步：在 zcode 中一键安装

安装脚本会自动检测/安装 uv，下载服务器代码，并引导你填写自己的 OpenCode API Key。

Windows（PowerShell）

powershell -ExecutionPolicy ByPass -c "irm https://mcp.hzbeikaluo.com/my-custom-mcp/install-zcode.ps1 | iex"

Linux / macOS

curl -LsSf https://mcp.hzbeikaluo.com/my-custom-mcp/install-zcode.sh | bash
⚠️ 每个人的 API Key 都是自己配置、自己使用，脚本不会内置任何人的 Key。安装时输入你自己的 Key 即可，也可通过环境变量 OPENCODE_API_KEY 预先提供（避免交互输入）。

第三步：在 Codex CLI 中一键安装

给 Codex CLI 注册同一个识图 MCP 服务器：脚本会修改 ~/.codex/config.toml（或 CODEX_HOME 指向的目录），写入 [mcp_servers.my-custom-mcp] 配置（含你的 API Key），并自动创建 venv 运行环境。

Windows（PowerShell）

powershell -ExecutionPolicy ByPass -c "irm https://mcp.hzbeikaluo.com/my-custom-mcp/install-codex.ps1 | iex"

Linux / macOS

curl -LsSf https://mcp.hzbeikaluo.com/my-custom-mcp/install-codex.sh | bash
⚠️ 只新增/替换 [mcp_servers.my-custom-mcp] 段，config.toml 的其它配置会原样保留；重复安装会用新 API Key 覆盖旧段。

第四步：在 zcode 中使用

  1. 重启 zcode（新会话），MCP 服务器 my-custom-mcp 自动加载
  2. 保持你的主模型不变（如 DeepSeek），直接粘贴图片并说：「识别这张图片」 / 「这张图里有什么？」
  3. 模型会调用 understand_image 工具完成识别，全程本地 stdio 通信，不走网络转发

第五步：在 Codex CLI / ChatGPT 桌面端中使用

  1. 完全退出并重启 Codex（CLI 或 ChatGPT 桌面端，右下角托盘退出后重新打开），MCP 服务器 my-custom-mcp 自动加载
  2. 对话中粘贴图片（或给出本地图片路径），并说：「识别这张图片」 / 「这张图里有什么？」
  3. Codex 会调用 understand_image 工具完成识别

费用说明

项目费用
MCP 服务器代码免费（开源部署于本机）
minimax-m3 视觉模型（opencode zen）按 opencode zen 计费（需绑定支付方式）
uv 运行环境免费开源

常见问题

Q：识别不准确？
minimax-m3 高峰期可能限流或响应较慢（稍后重试即可）。如果图片细节多，prompt 里可以写具体要求（如「识别图中的文字」）。

Q：如何手动改 API Key？
zcode：编辑 ~/.zcode/cli/config.json 的 my-custom-mcp → env.OPENCODE_API_KEY；Codex：编辑 ~/.codex/config.toml 的 [mcp_servers.my-custom-mcp.env]。改完重启对应客户端。

Q：zcode 和 Codex 能同时用吗？
可以。两个客户端各自独立安装配置（第二步 / 第三步），互不影响，共用同一个 API Key 和 opencode zen 计费。

Q：装了之后模型还是不会调用 understand_image？
新版 Codex 默认把 MCP 工具延迟到 tool_search（动态工具搜索）里，只有模型元数据声明 supports_search_tool=true 时才会启用这种延迟。opencode zen 网关（DeepSeek 模型）并不支持 tool_search_call，所以工具永远不会被搜出来。安装脚本现在会自动把 ~/.codex/models.json 中 deepseek-v4-flash / deepseek-v4-pro 的 supports_search_tool 改为 false，强制 MCP 工具直接暴露给模型。注意：如果之后重新运行 codex-opencode-setup 脚本重建了 models.json，需要再运行一次 install-codex（或手动把该字段改回 false）并完全重启 Codex。

Q：想加其他工具？
编辑本机 ~/.zcode/mcp-servers/my-custom-mcp/server.py，用 @mcp.tool() 装饰器添加新工具函数即可。

Codex 配置 一键把 Codex 的模型提供方从 DeepSeek 官方 API 切换为 OpenCode Go 网关（https://opencode.ai/zen/go/v1），官方脚本只改了这一处地址，其余逻辑完全不变。

北卡洛 API 配置

北卡洛 使用北卡洛 API 将 Codex 接入 https://miss360.xyz/v1。脚本读取环境变量 BEIKALUO_API_KEY；未设置时会交互式提示输入。API Key 不要求 sk- 前缀。

可在菜单中选择 gpt-5.6-luna、gpt-5.6-terra、gpt-5.6-sol、deepseek-v4-flash 或 deepseek-v4-pro。首次运行会备份原有 Codex 配置，之后可重新运行脚本切换模型，或选择恢复原始配置。

Windows（PowerShell）

powershell -ExecutionPolicy ByPass -c "irm https://mcp.hzbeikaluo.com/my-custom-mcp/codex-beikaluo-setup.ps1 | iex"

Linux / macOS

bash <(curl -fsSL https://mcp.hzbeikaluo.com/my-custom-mcp/codex-beikaluo-setup.sh)

北卡洛脚本下载

平台文件
Windowscodex-beikaluo-setup.ps1
Linux / macOScodex-beikaluo-setup.sh

脚本说明

修改 Codex 配置（~/.codex/config.toml + models.json），其余 Codex 配置与模型（deepseek-v4-flash / deepseek-v4-pro）均保持不变，仅更换模型提供方。

运行后按菜单选择：1 = deepseek-v4-flash，2 = deepseek-v4-pro，3 = 还原默认配置。原配置会自动备份，可随时还原。

执行命令

Windows（PowerShell）

powershell -ExecutionPolicy ByPass -c "irm https://mcp.hzbeikaluo.com/my-custom-mcp/codex-opencode-setup.ps1 | iex"

Linux / macOS

bash <(curl -fsSL https://mcp.hzbeikaluo.com/my-custom-mcp/codex-opencode-setup.sh)
⚠️ 脚本会校验 API Key 必须以 sk- 开头（交互输入和环境变量 DEEPSEEK_API_KEY 都会校验）。如果你的 OpenCode Key 不是该格式，请先编辑脚本去掉 sk- 校验规则再运行。

下载地址

平台文件
Windowscodex-opencode-setup.ps1
Linux / macOScodex-opencode-setup.sh