MiMo Free API MCP🚀 (V2.5 Series)

English | 简体中文

基于小米大模型（MiMo）官方网站（aistudio.xiaomimimo.com）逆向构建的高级 OpenAI 兼容网关 + 原生 MCP 插件集成。现已全量适配 MiMo V2.5 全模态 系列，支持 Thinking (思维链) 协议 与 Omni (全模态) 交互。

🏗️ 核心特性 (V2.5 Features)

V2.5 全模态适配: 深度集成 mimo-v2.5 与 mimo-v2.5-pro 模型，支持原生图像、视频、音频的复杂分析。
Thinking 协议对齐: 完美支持官方最新的思维链 (Reasoning) 协议。流式输出中自动包含 reasoning_content，真实还原 AI 思考过程。
透明升级路由: 保持对 V2 时代的兼容。请求 mimo-v2-omni 会自动平滑路由至 mimo-v2.5，mimo-v2-pro 会路由至 mimo-v2.5-pro。
环境化 Token 配置: 支持在 .env 中通过 token 环境变量（格式：ph.uid.token）完成一键部署。
Native MCP Server: 集成最新 MCP 标准。赋予 Claude / Cursor 等客户端原生的 联网搜索 (search) 与 视觉分析 (vision) 能力。

📊 模型矩阵 (Model Matrix)

模型 ID	基座能力	推理思维链 (Thinking)	核心优势
`mimo-v2.5`	全模态旗舰	✅ 默认开启	视觉、音频、多模态理解最佳方案
`mimo-v2.5-pro`	推理增强版	✅ 默认开启	逻辑严密、最强搜索与长文本分析
`mimo-v2-flash`	极速轻量版	可选 (后缀激活)	毫秒级响应，适合简单对话与翻译
`mimo-v2-omni`	(兼容 ID)	✅ (路由至 2.5)	兼容旧版 V2-Omni 客户端
`mimo-v2-pro`	(兼容 ID)	✅ (路由至 2.5-pro)	兼容旧版 V2-Pro 客户端

[!TIP]
强制开启 Thinking：您可以通过为模型 ID 添加 -thinking 后缀（如 mimo-v2-flash-thinking）强制激活任何模型的思维链模式。

[!WARNING]
工具调用 (Tool Calling) 限制：目前模型原生工具调用（Function Calling）极度不稳定，无法在 Agent（如 AutoGPT、LangChain Agent 等）中可靠使用。建议仅作为对话、视觉分析或通过 MCP 插件在支持的客户端（如 Claude/Cursor）中使用。

🔑 凭证配置 (Credentials)

项目支持通过环境变量或 API Header 传递凭证。

方式 A：一键式 .env 部署 (推荐)

在根目录创建 .env 文件（可参考 .env.example），填入从官网抓取的三段式 Token：

# 格式: ph.uid.token 或 抓包获取的长字符串
token=xxxxxxxx.yyyyyyyy.zzzzzzzz

方式 B：OpenAI Header 传递

直接在 API 调用时使用 Bearer Token：

Authorization: Bearer YOUR_MIMO_TOKEN

📂 本地路径支持 (Local File Access)

如果您在 Docker 环境下运行，由于容器隔离，服务默认无法直接读取宿主机路径。

核心工作流 (Workflow)：

多模式支持：本项目支持 URL、Base64 数据 以及 本地文件名。
挂载映射 (本地文件)：若需使用本地文件，请将其存放在宿主机目录中，并在 docker-compose.yml 中挂载到容器的 /app/media：
```
volumes:
  - /您的宿主机路径:/app/media:ro
```
直接访问：挂载完成后，您只需直接告诉 AI 文件名（如：“分析一下 test.mp4”），系统会自动在 /app/media 目录中寻址。

💡 提问技巧 (Prompting Guide)

文件名 (最推荐): "分析这个本地视频：demo.mp4"
URL 地址: "分析这张网上的图片：https://example.com/cat.jpg"
Base64: 直接将 Base64 数据 URI 粘贴给 AI 即可。
对比分析: "对比 local_image.png 和这个网页图片 https://.../2.jpg 的区别"

注意：请确保 AI 能够通过其工具集（Tools）访问到 vision 工具。本项目已在工具描述中告知 AI 支持多种来源。

🤖 MCP 插件集成 (Cursor / Claude)

本项目 MCP 服务集成在 8001 端口下，已全面升级至 2025 Streamable HTTP 标准。

客户端配置示例：

请将以下配置添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "mimo": {
      "url": "http://localhost:8001/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

提供的工具 (Tools)

search(query): AI 自动调用 Mimo 联网搜索。
vision(query, image): AI 分析图像、视频、音频或本地资源（支持本地绝对路径、Base64 或 URL）。

🐳 快速部署 (Deployment)

# 1. 确保 .env 已配置 token
# 2. 启动容器
docker compose up -d --build

⚖️ 声明

本项目仅供学术交流，请遵守小米 MiMo 官方用户协议。

mimo-free-api-mcp