MiMo Image Reader MCP

让 Claude Code 中的 MiMo 2.5 Pro 支持图片识别

当你在 Claude Code 中使用小米 MiMo 2.5 Pro 模型时，如果发送图片会报错（因为 2.5 Pro 不支持图片）。这个工具解决了这个问题：

检测到图片 → 自动切换到 MiMo 2.5 识别 → 将结果返回给 2.5 Pro → 2.5 Pro 继续处理

✨ 核心特点

🔄 自动切换：检测到图片时自动从 2.5 Pro 切换到 2.5 模型
🖼️ 图片识别：使用 MiMo 2.5 视觉模型分析图片内容
🔁 智能回传：将识别结果返回给 2.5 Pro 继续处理
⚡ 无感切换：用户无需手动切换模型，完全透明
🚀 自动运行：Claude Code 启动时自动启动，无需手动管理

🔄 工作流程

用户发送图片
    ↓
Claude Code (MiMo 2.5 Pro) 接收请求
    ↓
Smart Proxy 检测到图片内容
    ↓
自动切换到 MiMo 2.5 模型识别图片
    ↓
MiMo 2.5 返回图片描述
    ↓
描述结果返回给 MiMo 2.5 Pro
    ↓
2.5 Pro 继续处理并返回给用户

用户视角：直接发送图片，无需任何操作，2.5 Pro 自动完成所有处理

Python 3.9 或更高版本
Claude Code
小米 MiMo API Key（获取地址）

🚀 快速安装

方法一：自动安装（推荐）

双击运行 install.bat
按照提示输入你的 API Key
重启 Claude Code

方法二：手动安装

复制文件

# 创建目录
mkdir -p ~/.claude/mcp-servers/mimo-image-reader

# 复制 server.py 到该目录
cp server.py ~/.claude/mcp-servers/mimo-image-reader/

配置 MCP

编辑 ~/.claude/.mcp.json，添加以下内容：

{
  "mcpServers": {
    "mimo-image-reader": {
      "command": "python",
      "args": [
        "C:/Users/你的用户名/.claude/mcp-servers/mimo-image-reader/server.py"
      ],
      "env": {
        "MIMO_API_KEY": "你的API密钥"
      }
    }
  }
}

重启 Claude Code

📖 使用方法

方式一：直接发送图片（推荐）

在 Claude Code 聊天窗口中：

粘贴图片（Ctrl+V）
发送消息
Smart Proxy 会自动识别图片并使用 MiMo v2.5 处理

方式二：读取图片文件

在对话中让 Claude Code 读取图片：

请帮我看看这张图片：C:/Users/xxx/Desktop/screenshot.png

Claude Code 会自动调用 MCP 工具处理图片。

🔧 配置说明

环境变量

| 变量名 | 说明 | 默认值 | |--------|------|--------| | MIMO_API_KEY | 小米 MiMo API 密钥 | 无（必须设置） | | MIMO_BASE_URL | API 端点地址 | https://token-plan-cn.xiaomimimo.com/anthropic |

CC Switch 用户

如果你使用 CC Switch 代理，需要在 CC Switch 中修改 Claude Desktop 的配置：

打开 CC Switch
找到 Claude Desktop 的 Provider
将 API 地址修改为：http://127.0.0.1:15723
保存并重启 CC Switch

📁 文件结构

mimo-image-reader/
├── server.py          # MCP 服务器 + Smart Proxy
├── install.bat        # 安装脚本
└── README.md          # 使用说明

🐛 常见问题

Q: 图片识别不工作？

A: 检查以下几点：

API Key 是否正确配置
Claude Code 是否已重启
查看 Claude Code 日志是否有错误信息

Q: 如何查看日志？

A: MCP 服务器的日志会输出到 stderr，可以在 Claude Code 的开发者工具中查看。

Q: 支持哪些图片格式？

A: 支持 PNG、JPEG、GIF、WebP、BMP 等常见格式。

Q: 可以修改使用的模型吗？

A: 可以。编辑 server.py 文件，修改 MODEL 变量：

MODEL = "mimo-v2.5"  # 改为你想使用的模型

📝 更新日志

v2.0.0 (2026-06-05)

✨ 集成 Smart Proxy，自动路由图片请求
⚡ 支持自动启动，无需手动管理代理
🔧 优化配置，支持 CC Switch 代理

v1.0.0

🎉 初始版本
📷 支持图片文件读取
🤖 集成 MiMo v2.5 视觉模型

📄 许可证

MIT License

🙏 致谢

小米 MiMo - 提供视觉模型 API
Claude Code - AI 编程助手
Model Context Protocol - MCP 协议

如有问题或建议，欢迎提交 Issue！

MCP Servers