mimo-vision
Provides image analysis capabilities using Xiaomi's MiMo-V2.5 vision model, allowing AI agents to analyze, compare, and inspect UI images through an OpenAI-compatible API.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mimo-visionAnalyze ./screenshots/home.png and suggest fixes"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mimo-vision MCP Server
本地 stdio MCP Server:给 Claude Code(主模型可以是 DeepSeek 等任何模型)提供"视觉眼睛"。 把本地图片交给小米 MiMo-V2.5 图片理解模型分析,返回文本结果供主 Agent 继续工作。
安装位置:
C:\Users\MR\.claude\mcp\mimo-vision视觉模型:
mimo-v2.5(官方 OpenAI-compatible 接口https://api.xiaomimimo.com/v1/chat/completions,直接调用无中间层)安全:只做"读图片 → 调 MiMo API → 返回文本",无文件写入/删除/shell 能力
API Key 运行时从环境变量
MIMO_API_KEY读取,绝不写入源码、配置或日志
配置 MIMO_API_KEY(Windows)
PowerShell 或 CMD 执行:
setx MIMO_API_KEY "你的Key"然后完全退出并重启 Claude Code(MCP 无需重新注册)。
Related MCP server: gimmick-vision-mcp
注册到 Claude Code(user scope,所有项目可用)
claude mcp add -s user mimo-vision -- "C:\Program Files\nodejs\node.exe" "C:\Users\MR\.claude\mcp\mimo-vision\server.js"验证:
claude mcp list # 应显示: mimo-vision ✔ Connected三个 Tool
Tool | 参数 | 用途 |
|
| 分析一张图:布局、排版、间距、配色、视觉问题 |
|
| 一次跨图对比:相同点/差异/布局/排版/间距/颜色/组件/比例/层级 + 对改代码最有价值的信息 |
|
| UI 工程化分析,13 项结构化结果(Layout、尺寸比例、Grid、Spacing、Typography、Colors、边框圆角阴影、组件层级、图片比例、响应式线索、交互线索、差异问题、实现建议),可直接用于写 HTML/CSS/React |
图片路径支持:Windows 绝对路径(含中文/空格/反斜杠)或相对项目根目录的路径。 格式:JPEG/JPG/PNG/WebP/GIF/BMP;单张 Base64 不超过 50MB(超限返回明确错误并提示压缩)。
使用示例(对主 Agent 直接说)
"看一下 ./screenshots/home.png,分析为什么这个页面显得太拥挤。"
"对比 ./current.png 和 ./reference.png,然后修改当前页面使它更接近参考图。"
"检查 ./result.png,看看这次前端修改还有哪些视觉问题。"
"我要复刻 ./design.png 这个页面,先做 UI 分析再写代码。"
自测
cd C:\Users\MR\.claude\mcp\mimo-vision
node test/mcp-client-test.mjs # 14 项基础+失败测试(无需 Key)
node test/mcp-client-test.mjs --real # 再加真实 MiMo 调用(需已设置 MIMO_API_KEY)测试图生成:node test/make-test-images.mjs(纯 Node 零依赖生成 PNG)。
排错
现象 | 处理 |
报错 | 按上文 setx 设置后重启 Claude Code |
报错 | 常见于部分 WebP 编码(如带 ICC profile)MiMo 无法解析:把图片转成 PNG 后重试(可用图片查看器另存为,或 |
报错 | Key 错误或失效,到小米 MiMo 开放平台检查 |
报错 | 限流,稍后重试(服务端已自动重试 2 次) |
报错 | 压缩/缩小图片(单张 Base64 ≤ 50MB) |
报错 | 转成 PNG/JPG 等支持的格式 |
网络错误 | 检查网络/代理;服务端对网络错误自动退避重试 |
卸载
claude mcp remove mimo-vision然后删除目录 C:\Users\MR\.claude\mcp\mimo-vision;如不再使用 MiMo,再执行 setx MIMO_API_KEY ""。
Available Tools
3 toolsanalyze_imageA
用 MiMo-V2.5 视觉模型分析一张本地图片(UI 截图、网页截图、报错截图、设计参考图等),返回布局、排版、间距、配色与视觉问题等分析结果,供 Coding Agent 直接使用。
主动调用时机(用户提到以下任一情况时,应主动调用本工具,无需用户明确说"调用 MCP"):用户要求"看看/分析这张图";用户给出本地截图路径;涉及 UI/网页/报错截图;涉及设计参考图;要提取图片中的文字或内容;视觉验收;判断当前实现是否接近参考图。
参数:image_path 必填;prompt 可选,指定重点分析什么。
| Name | Required | Description | Default |
|---|---|---|---|
| prompt | No | 可选:告诉视觉模型重点分析什么(如布局、配色、可读性等)。留空则使用默认视觉分析清单。 | |
| image_path | Yes | 本地图片路径:Windows 绝对路径(如 C:\screenshots\a.png)或相对项目根目录的路径(如 ./screenshots/a.png)。支持中文、空格、反斜杠。支持 JPEG/JPG/PNG/WebP/GIF/BMP,单张 Base64 不超过 50MB。 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Since no annotations are provided, the description carries full responsibility for behavioral disclosure. It names the model (MiMo-V2.5), the scope of analysis, and states results are for direct use. However, it does not specify the output format or limitations, which keeps it from a 5.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is front-loaded with its purpose and then organizes when-to-use cases in a clear paragraph. It is somewhat long but every section earns its place; the parameter summary is slightly redundant but not wasteful. Efficiency is good, though not as tight as a two-sentence high example.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple 2-parameter tool with no output schema, the description is adequately complete: it explains what it does, when to use it, and the parameters are fully covered by the schema. The only notable gap is the lack of output format information, but overall it does not leave major ambiguities.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, with both image_path and prompt already having detailed descriptions in the schema. The description's parameter paragraph merely restates what the schema offers (image_path required, prompt optional) and adds no new semantic meaning, so it remains at the baseline for high schema coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it uses the MiMo-V2.5 vision model to analyze a local image and returns layout, typography, spacing, color, and visual issue analysis. This gives a specific verb and resource, but does not explicitly distinguish it from sibling tools like compare_images or inspect_ui.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description includes a dedicated '主动调用时机' (proactive invocation timing) section listing concrete triggers such as '用户要求看看/分析这张图' or when the user provides a screenshot path. This provides clear when-to-use guidance, but it does not mention alternatives or when not to use this tool, missing the full 5.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
compare_imagesA
用 MiMo-V2.5 视觉模型一次性对比 2~8 张本地图片(当前页面 vs 目标设计、修改前 vs 修改后、多个设计方案),模型直接跨图比较(不是分别分析后拼接)。返回:每张图概括、相同点、差异、布局/Typography/Spacing/Color/Component/图片比例/视觉层级变化,以及对代码修改最有价值的信息。
主动调用时机:用户要求"对比设计图与当前实现"、"根据目标图修改项目"、视觉回归、多方案比较时。
参数:image_paths 按顺序传入(顺序有语义:通常第一张是当前实现,后面是目标/参考图);prompt 可选。
| Name | Required | Description | Default |
|---|---|---|---|
| prompt | No | 可选:指定对比重点(如'重点对比导航栏与配色')。 | |
| image_paths | Yes | 2~8 张本地图片路径,按顺序传入。顺序有语义:通常第一张是当前实现,其余为目标/参考图。本地图片路径:Windows 绝对路径(如 C:\screenshots\a.png)或相对项目根目录的路径(如 ./screenshots/a.png)。支持中文、空格、反斜杠。支持 JPEG/JPG/PNG/WebP/GIF/BMP,单张 Base64 不超过 50MB。 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden. It discloses that the model compares images directly across images (not separately analyzing then stitching) and details the returned information, including visual hierarchy changes. It doesn't mention limitations or failure modes, but core behavior is well covered.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is moderately sized but front-loaded with the main action, followed by return details, use cases, and parameters. Every sentence adds value, though it could be slightly more concise by merging repetitive parameter mentions.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a multi-image comparison tool with no output schema, the description adequately covers purpose, timing, parameters, and return categories. It lacks explicit output formatting or failure details, but is sufficient for an agent to select and invoke the tool correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema covers 100% of parameters, including image_paths order semantics, path formats, and optional prompt. The description reiterates order semantics but adds no new information beyond the schema, so the baseline of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool compares 2-8 local images using a vision model, with a specific list of output categories (summary, differences, layout changes, etc.). It distinguishes itself from sibling tools like analyze_image and inspect_ui by emphasizing cross-image comparison rather than single-image analysis.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides explicit invocation timing under '主动调用时机', listing scenarios such as design-to-implementation comparison, visual regression, and multi-scheme evaluation. However, it does not explicitly name sibling tools as alternatives or state when not to use it, so it lacks full exclusion guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
inspect_uiA
用 MiMo-V2.5 视觉模型对 UI 截图做工程化分析,专供 Coding Agent 复刻/修改前端使用(结果是结构化设计数据,不是文学描述)。返回 13 项:Layout、近似尺寸与比例、Grid/columns、Spacing、Typography、Colors、边框/圆角/阴影、组件层级、图片位置与比例、响应式线索、交互线索、差异/问题、可执行实现建议——可直接用于写 HTML/CSS/React。
主动调用时机:用户要"复刻这个页面"、"按截图/设计图改前端"、"根据参考图实现 UI"时。
参数:image_path 或 image_paths 二选一(多图时逐个说明角色与差异);task 说明目标(如"我要复刻这个页面");project_context 可选,提供技术栈等背景。
| Name | Required | Description | Default |
|---|---|---|---|
| task | No | 任务目标,如'我要复刻这个页面'、'把当前页面改成目标图的样子'。 | |
| image_path | No | 单张 UI 截图路径(与 image_paths 二选一)。本地图片路径:Windows 绝对路径(如 C:\screenshots\a.png)或相对项目根目录的路径(如 ./screenshots/a.png)。支持中文、空格、反斜杠。支持 JPEG/JPG/PNG/WebP/GIF/BMP,单张 Base64 不超过 50MB。 | |
| image_paths | No | 多张 UI 截图路径(与 image_path 二选一)。本地图片路径:Windows 绝对路径(如 C:\screenshots\a.png)或相对项目根目录的路径(如 ./screenshots/a.png)。支持中文、空格、反斜杠。支持 JPEG/JPG/PNG/WebP/GIF/BMP,单张 Base64 不超过 50MB。 | |
| project_context | No | 可选:项目背景(技术栈、框架、已有样式系统等),帮助给出更贴合的工程建议。 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the burden of behavioral disclosure. It reveals the model used (MiMo-V2.5), that the output is structured design data rather than literary prose, the exact 13 result categories, and the timing for proactive invocation. It stops short of stating return format details (e.g., whether output is JSON or a document) or any side effects/auth needs, but given that the tool is a vision analysis over local image paths, the disclosed behavior is adequately transparent for an AI agent.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is substantial but well-structured: it leads with the model and purpose, then a compact list of the 13 return items, then a clear '主动调用时机' paragraph, and finally parameter guidance. Each sentence earns its place, though the 13-item enumeration is somewhat long. Front-loading is effective: the first sentence immediately tells the agent what the tool does and for whom.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with no annotations and no output schema, the description does a solid job: it explains the output structure (13 named items), gives concrete trigger phrases, and clarifies parameter roles. It doesn't specify the exact output format (JSON vs. text) or how errors are handled, which are minor gaps. Given the tool's moderate complexity (mutually exclusive parameters, optional context, multi-image support), the description is sufficiently complete for an agent to invoke it correctly in most scenarios.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the structured schema already documents all four parameters thoroughly, including file path examples and supported formats. The description adds value beyond the schema by explaining the conceptual roles of the parameters: '多图时逐个说明角色与差异' for image_paths, 'task 说明目标' with examples, and 'project_context 可选,提供技术栈等背景'. This semantic framing helps the agent map user intent to the correct parameter values.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description opens with a specific verb ('用 MiMo-V2.5 视觉模型对 UI 截图做工程化分析') and clearly identifies the resource (UI screenshots) and purpose (replicating/modifying frontend for Coding Agents). It distinguishes itself from generic image analysis by emphasizing structured design data, listing the 13 return items, and stating when to proactively call it (e.g., user asks to '复刻这个页面' or '按截图/设计图改前端'). This separates it from siblings like analyze_image or compare_images.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description includes a dedicated '主动调用时机' section that explicitly states when to use this tool ('用户要复刻这个页面', '按截图/设计图改前端', '根据参考图实现 UI'). It also clarifies that task describes the goal and project_context is optional, and the image_path/image_paths mutual exclusivity guides selection. Although it does not name sibling alternatives explicitly to exclude, the trigger conditions are concrete and distinct enough to prevent confusion with analyze_image/compare_images.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
TDQS
analyze_image and inspect_ui have significant overlap for UI screenshots; both analyze a single image with similar use cases. compare_images is distinct, but the boundaries between the two single-image tools are unclear in practice.
Tool names follow a consistent verb_noun pattern (analyze, compare, inspect), though nouns vary in number and specificity (image, images, ui). Minor inconsistencies exist but the pattern is predictable.
Three tools is a small but reasonable set for a vision-analysis server focused on coding assistance. Each tool serves a distinct purpose, though the overlap between analyze_image and inspect_ui suggests one could be redundant.
The domain of vision analysis for coding agents is well covered: single-image analysis, multi-image comparison, and detailed UI structure extraction. Minor gaps exist (e.g., no explicit batch processing without comparison), but core workflows are supported.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
Analyze images from multiple angles to extract detailed insights or quick summaries. Describe visu…
Generate and edit images and create short videos inside Claude. Prepaid credits, no subscription.
Analyze images and videos with Gemini to get fast, reliable visual insights. Handle content from U…
Holiday photo MCP server: list and fetch personal holiday photos inline in Claude chat.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables Claude Code to describe images and extract text using Kimi/Moonshot vision API. Supports local image files with customizable prompts.2MIT
- AlicenseNot gradedqualityDmaintenanceBridges Claude Code to local OpenAI-compatible vision models, enabling image analysis, comparison, and OCR via three tools.2MIT
- FlicenseNot gradedqualityCmaintenanceEnables Claude Code to analyze images using multiple visual models (Kimi, OpenAI, etc.) and summarize results with DeepSeek. Supports dynamic switching of visual providers and handles both text and image inputs.1
- FlicenseNot gradedqualityBmaintenanceAnalyzes images using a vision model and returns detailed Chinese text descriptions, enabling text-only models to understand pictures from screenshots, UI designs, error logs, and architecture diagrams.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Channel-Carl/mimo-vision'
If you have feedback or need assistance with the MCP directory API, please join our Discord server