MIMO Image Recognition MCP
一个调用小米 MIMO 多模态模型进行图片理解的 MCP Server。
该 MCP 支持:
- 本地图片路径识别
- 网络图片 URL 识别
- Agent 自定义提示词
- API Key、请求地址、模型名称通过 MCP 启动配置传入
- 支持通过 PyPI / uvx 运行
- 支持本地源码运行
功能说明
本项目会向 MCP 客户端暴露一个工具:
understand_image
用于调用 MIMO 多模态模型理解图片。
支持的输入方式:
image_path: 单张本地图片路径image_url: 单张网络图片 URLimage_paths: 多张本地图片路径image_urls: 多张网络图片 URLprompt:由 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.