Skip to main content

MIMO Image Recognition MCP

一个调用小米 MIMO 多模态模型进行图片理解的 MCP Server。

该 MCP 支持:

  • 本地图片路径识别
  • 网络图片 URL 识别
  • Agent 自定义提示词
  • API Key、请求地址、模型名称通过 MCP 启动配置传入
  • 支持通过 PyPI / uvx 运行
  • 支持本地源码运行

功能说明

本项目会向 MCP 客户端暴露一个工具:

understand_image

用于调用 MIMO 多模态模型理解图片。

支持的输入方式:

  • image_path: 单张本地图片路径
  • image_url: 单张网络图片 URL
  • image_paths: 多张本地图片路径
  • image_urls: 多张网络图片 URL
  • prompt:由 Agent 自己决定的图片理解任务
  • system_prompt:可选系统提示词
  • temperature:输出随机性
  • max_tokens:最大输出长度

安装方式一:通过 PyPI / uvx 使用

如果你只是想使用这个 MCP,推荐使用这种方式。

MCP 配置示例:

{
  "mcpServers": {
    "mimo-image-recognition": {
      "command": "uvx",
      "args": [
        "--refresh",
        "mimo-image-recognition-mcp"
      ],
      "env": {
        "MIMO_API_KEY": "用户自己的 API Key",
        "MIMO_API_BASE": "https://token-plan-cn.xiaomimimo.com/v1",
        "MIMO_MODEL": "mimo-v2.5"
      }
    }
  }
}

配置项说明:

配置项 说明
MIMO_API_KEY 你的 MIMO API Key
MIMO_API_BASE MIMO API 请求地址,通常为 https://api.xiaomimimo.com/v1或https://token-plan-cn.xiaomimimo.com/v1
MIMO_MODEL 要调用的 MIMO 模型名称,例如 mimo-v2.5

安装方式二:本地源码运行

如果你想修改源码或参与开发,可以使用本地源码方式。

1. 克隆项目

git clone https://github.com/Mriestac/mimo-image-recognition-mcp.git
cd mimo-image-recognition-mcp

2. 安装依赖

uv sync

3. MCP 配置示例

{
  "mcpServers": {
    "mimo-image-recognition": {
      "command": "uv",
      "args": [
        "--directory",
        "<你的项目路径>",
        "run",
        "mimo-image-recognition-mcp"
      ],
      "env": {
        "MIMO_API_KEY": "你的 MIMO API Key",
        "MIMO_API_BASE": "https://token-plan-cn.xiaomimimo.com/v1",
        "MIMO_MODEL": "mimo-v2.5"
      }
    }
  }
}

请把 <你的项目路径> 改成你自己本地项目的真实路径。


本地调试

可以使用 MCP Inspector 调试:

uv run mcp dev src/mimo_image_recognition_mcp/server.py

如果能看到:

understand_image

说明 MCP Server 启动成功。

如果你想在 MCP Inspector 中实际调用 MIMO 接口,可以在当前终端临时设置:

Windows PowerShell

$env:MIMO_API_KEY="你的 MIMO API Key"
$env:MIMO_API_BASE="https://api.xiaomimimo.com/v1"
$env:MIMO_MODEL="mimo-v2.5"

uv run mcp dev src/mimo_image_recognition_mcp/server.py

License

MIT

Metadata

Release files for mimo-image-recognition-mcp 0.1.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mimo-image-recognition-mcp 0.1.4
File Size Uploaded Provenance Actions
mimo_image_recognition_mcp-0.1.4.tar.gz 52.7 kB Without provenance Details for mimo_image_recognition_mcp-0.1.4.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for mimo-image-recognition-mcp 0.1.4
File Interpreter ABI Platform Actions
mimo_image_recognition_mcp-0.1.4-py3-none-any.whl Python 3 none any Details for mimo_image_recognition_mcp-0.1.4-py3-none-any.whl

Total release size: 59.5 kB

Release files / mimo_image_recognition_mcp-0.1.4.tar.gz

Download URL mimo_image_recognition_mcp-0.1.4.tar.gz
Size 52.7 kB
Tags Source
SHA-256 checksum
How to use checksums
a758a55662118eff0f6bb2f556a7a64db9e323dd1439d89be17c43c91b0fdbb0
BLAKE2b-256 checksum
How to use checksums
36fa6f8363655fc3ade34d53a983b91944892af8f7c1174b60375aa20fc8a58d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / mimo_image_recognition_mcp-0.1.4-py3-none-any.whl

Download URL mimo_image_recognition_mcp-0.1.4-py3-none-any.whl
Size 6.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6f2b6afb8cea8790041ecf2a7da7a0d82931269ec3723a79b692bfe771821130
BLAKE2b-256 checksum
How to use checksums
f95c31756034bc26713a7af429e4c44b7e5966f6465b50d7b76d3615bbe74fd4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for mimo-image-recognition-mcp 0.1.4

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page