MiMo Vision

为 Claude Code 提供图片识别能力的 MCP 服务器，解决 MiMo v2.5 Pro 不支持多模态 的问题。

问题背景

MiMo 系列中，支持图片输入的模型只有：

• mimo-v2.5
• mimo-v2-omni

mimo-v2.5-pro 不支持图片识别。

当你在 Claude Code 中使用 mimo-v2.5-pro 作为主模型时，如果直接发送图片（比如拖入截图、粘贴报错截图），Claude Code 会尝试把图片发给模型，触发类似以下错误：

There's an issue with the selected model (mimo-v2.5-pro[1m]).
It may not exist or you may not have access to it.
Run /model to pick a different model.

更严重的是，这个错误会导致当前会话直接崩溃，之后连普通文本对话也无法继续。

三种解决办法

方案	做法	优点	缺点
治标	/compact 压缩上下文	快速恢复会话	压缩后仍不能发图片，且会丢失上下文
治头	换成 mimo-v2.5 模型	原生支持图片	性能远不如 Pro，代码生成能力下降
治本	安装本 MCP 服务器	兼顾 Pro 性能 + 图片识别	需要额外配置一次

本方案原理

用户发送图片
    ↓
Claude Code（mimo-v2.5-pro）—— 不直接处理图片
    ↓ 调用 MCP 工具
MiMo Vision MCP Server
    ↓ 转发给支持视觉的模型
mimo-2.5（支持多模态）—— 返回文字描述
    ↓
Claude Code 拿到文字描述，继续正常对话

主模型保持 mimo-v2.5-pro 的高性能，图片识别通过 MCP 借助 mimo-2.5 完成，互不干扰。

---

完整配置步骤

前提： 系统已安装 Node.js 16+ 和 Python 3.10+

第一步：注册 MCP 服务器

编辑 Claude Code 全局配置文件 ~/.claude/settings.json，在 mcpServers 字段中添加：

{
  "mcpServers": {
    "mimo-vision": {
      "command": "npx",
      "args": ["-y", "@makoto82/mimo-vision-mcp"],
      "env": {
        "MIMO_API_KEY": "your-api-key-here"
      }
    }
  }
}

把 your-api-key-here 换成你的 MiMo API Key。

settings.json 在哪里？

• Windows：C:\Users\<你的用户名>\.claude\settings.json
• macOS / Linux：~/.claude/settings.json

如果文件不存在，新建一个即可。

第二步：配置图片读取规则

编辑全局提示词文件 ~/.claude/CLAUDE.md，加入以下内容：

# 图片读取规则
当模型为 mimov2.5pro 时，读取图片必须优先使用 mimo-vision MCP 提供的
`mcp__mimo-vision__describe_image` 或 `mcp__mimo-vision__ocr_image` 工具，
不要用 Read 工具直接读取图片。

为什么需要这一步？ 仅安装 MCP 服务器还不够。若没有提示词约束，Claude Code 在遇到图片时仍可能尝试用 Read 工具直接读取图片，触发模型报错导致会话崩溃。

第三步：重启 Claude Code

重启后，npx 会自动下载包 → 自动安装 Python 依赖 → 自动启动服务器。全程无需手动操作，以后每次启动 Claude Code 也都会自动管理。

---

环境变量说明

变量	必填	默认值	说明
MIMO_API_KEY	是	—	MiMo API Key
MIMO_API_BASE	否	https://token-plan-cn.xiaomimimo.com/anthropic	API 地址
MIMO_MODEL	否	mimo-2.5	视觉模型名称

环境变量在 settings.json 的 env 字段中配置，Claude Code 启动 MCP 进程时自动注入，无需手动设置系统变量。

建议搭配 ccswitch 使用，方便快速切换 API Key 和模型配置。

---

提供的工具

工具名	功能	参数
describe_image	分析图片并返回文字描述	image_path（路径/URL/data URI）、prompt（提问，默认"描述图片内容"）
ocr_image	提取图片中的文字（OCR）	image_path（路径/URL/data URI）、language（语言，默认"中英文"）

使用示例

配置完成后，在 Claude Code 中直接说：

帮我看看这张截图的内容：D:\screenshots\error.png

Claude Code 会自动调用 describe_image 工具，无需手动指定。

---

已知限制：VS Code 终端无法直接拖入图片

目前 没有找到办法 解决 VS Code 终端直接拖入图片识别的问题。

在 VS Code 终端中拖入图片后，Claude Code 会尝试将图片直接发给主模型处理（而不是通过 MCP），触发如下错误：

❯ [Image #1]
[image content]

● There's an issue with the selected model (mimo-v2.5-pro[1m]).
It may not exist or you may not have access to it.
Run /model to pick a different model.

替代方案： 先将图片保存到本地文件，然后告诉 Claude 图片路径：

帮我看看这张截图：D:\screenshots\error.png

根本原因是 Claude Code 在终端拖入图片时会直接将图片内联发送给模型，绕过了 MCP 工具调用流程，目前无法拦截或重定向。

---

手动安装（不依赖 Node.js）

如果你不想用 npx，也可以手动安装：

git clone https://github.com/gbz666/mimo-vision-mcp.git
cd mimo-vision-mcp
pip install mcp httpx

然后在 settings.json 中改为：

{
  "mcpServers": {
    "mimo-vision": {
      "command": "python",
      "args": ["/path/to/mimo-vision-mcp/mimo_vision.py"],
      "env": {
        "MIMO_API_KEY": "your-api-key-here"
      }
    }
  }
}

---

依赖

• Python 3.10+
• mcp>=1.0.0
• httpx>=0.27.0