{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_jm69g8gb66ww","handle":"mimo-vision-mcp-2","url":"https://wellknown.network/agents/mimo-vision-mcp-2","links":{"self":"https://wellknown.network/agents/mimo-vision-mcp-2/record.json","html":"https://wellknown.network/agents/mimo-vision-mcp-2","markdown":"https://wellknown.network/agents/mimo-vision-mcp-2/record.md","api":"https://wellknown.network/api/v1/agents/mimo-vision-mcp-2","status":"https://wellknown.network/api/v1/agents/mimo-vision-mcp-2/status","claim":"https://wellknown.network/agents/mimo-vision-mcp-2/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mimo-vision-mcp-2/claim.json","badge":"https://wellknown.network/agents/mimo-vision-mcp-2/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mimo-vision-mcp-2/history","tools":"https://wellknown.network/api/v1/agents/mimo-vision-mcp-2/tools"},"ard":{"identifier":"urn:air::server:mimo-vision-mcp-2","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mimo-vision-mcp","summary":"MCP server for visual understanding via Xiaomi MIMO multimodal API","description":"# mimo-vision-mcp\n\n基于小米 MIMO API（mimo-v2.5 / mimo-v2.5-pro）的多模态理解 MCP 服务，支持图片、音频、视频三类理解能力。\n\n> **v0.4.1 修复**：修复 `analyze_*` 工具调用必现的 `TypeError: Completions.create() got an unexpected keyword argument 'thinking'`——`thinking` 是 MiMo 自定义顶层请求体字段，需经 `extra_body` 传入，不能作为 OpenAI SDK 的 `create()` 关键字参数。\n>\n> **v0.4.0 迁移提示**：11 个旧工具（`analyze_image` / `analyze_image_url` / `analyze_multiple_images` / `analyze_multiple_images_url` 等）已合并为 4 个新工具（`analyze_image` / `analyze_audio` / `analyze_video` / `estimate_video_tokens`）。`targets` 为列表（单张媒体传单元素列表），可混合本地路径与公网 URL；`prompt` 由可选改为**必填**。引用旧工具名的配置/提示词需迁移。\n\n## 使用\n\n```bash\nuvx mimo-vision-mcp\n```\n\n### 注册配置\n\n在 MCP 客户端的 server 配置（如 `.mcp.json`）中注册 `mimo-vision-mcp`。每个配置项有两种等价写法：`args`（命令行参数 `--xxx`）或 `env`（环境变量 `MIMO_XXX`），**二选一即可**；都填时 `--xxx` 优先。\n\n| 配置 | 必填/可选 | 默认值 | 说明 |\n|---|---|---|---|\n| `env.MIMO_API_KEY` | **必填** | — | API 密钥，缺失启动报错 |\n| `env.MIMO_MODEL` 或 `--model <名称>` | 可选 | `mimo-v2.5` | 模型名（`mimo-v2.5` / `mimo-v2.5-pro`） |\n| `env.MIMO_THINKING` 或 `--thinking <值>` | 可选 | `disabled` | 默认思维模式（`disabled` / `enabled` / `enabled_with_reasoning`） |\n| `env.MIMO_MAX_COMPLETION_TOKENS` 或 `--max-completion-tokens <正整数>` | 可选 | 不传（官方默认：`mimo-v2.5` 32768 / `mimo-v2.5-pro` 131072） | 输出 token 上限 |\n\n**写法 A：全部用命令行参数（`args`）**\n\n```json\n{\n  \"mcpServers\": {\n    \"mimo-vision\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mimo-vision-mcp\", \"--model\", \"mimo-v2.5-pro\", \"--thinking\", \"enabled\"],\n      \"env\": { \"MIMO_API_KEY\": \"sk-xxx\" }\n    }\n  }\n}\n```\n\n**写法 B：全部用环境变量（`env`）**\n\n```json\n{\n  \"mcpServers\": {\n    \"mimo-vision\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mimo-vision-mcp\"],\n      \"env\": {\n        \"MIMO_API_KEY\": \"sk-xxx\",\n        \"MIMO_MODEL\": \"mimo-v2.5-pro\",\n        \"MIMO_THINKING\": \"enabled_with_reasoning\",\n        \"MIMO_MAX_COMPLETION_TOKENS\": \"8192\"\n      }\n    }\n  }\n}\n```\n\n> 两种写法等价，选一种风格即可。仅 `MIMO_API_KEY` 必填，其余可选（不配用默认值）。\n\n**参数优先级**（对 `thinking` / `max_completion_tokens`）：\n\n```\n工具调用显式传参  >  --xxx 命令行参数  >  $MIMO_XXX 环境变量  >  内置默认值\n```…","publisher":null,"homepage":null,"repository":null,"version":"0.4.1","license":null,"protocols":["mcp"],"tags":["mcp","multimodal","vision","xiaomi"],"pricing":null,"endpoints":[{"url":"pypi:mimo-vision-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"media.image-understanding","name":"Image Understanding","confidence":1,"provenance":"declared"}],"categories":["media"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mimo-vision-mcp","registry":"pypi","observedAt":"2026-10-22T13:23:44.370Z","publishedAt":"2026-08-03T14:00:45.979933Z","latestVersion":"0.4.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mimo-vision-mcp","url":"https://pypi.org/project/mimo-vision-mcp/","firstSeenAt":"2026-09-10T06:23:07.820Z","fetchedAt":"2026-10-22T13:22:05.350Z","normalizedAt":"2026-10-22T13:22:05.350Z"}]},"firstSeenAt":"2026-09-10T06:23:07.820Z","updatedAt":"2026-10-22T13:23:44.370Z"}