mimo-vision-claude 1.0.0

package/README.md

@@ -0,0 +1,113 @@
+# MiMo Vision MCP Server
+
+> 封装小米 MiMo 全模态大模型视觉 API，为 Claude Code 等 MCP 客户端提供图片识别（识图）能力。
+
+## 功能
+
+- **通用图片描述** (`describe_image`) — 对任意图片进行内容描述，支持自定义提示词
+- **OCR 文字提取** (`ocr_image`) — 从图片中提取文字，支持中/英/日/韩/自动检测
+- **双图对比分析** (`compare_images`) — 对比两张图片的异同，多维度分析
+- **截图/UI 分析** (`analyze_screenshot`) — 分析 UI 截图，评估布局、可用性、可访问性
+
+## 快速开始
+
+### 前置条件
+
+- Node.js >= 18
+- MiMo 平台 API Key
+
+### 安装运行
+
+```bash
+# 设置 API Key
+export MIMO_API_KEY=your-api-key-here
+
+# 通过 npx 一键运行
+npx -y mimo-vision-claude
+```
+
+### Claude Code 集成
+
+在 `settings.json` 的 `mcpServers` 中添加：
+
+```json
+{
+  "mcpServers": {
+    "mimo-vision": {
+      "command": "npx",
+      "args": ["-y", "mimo-vision-mcp"],
+      "env": {
+        "MIMO_API_KEY": "${MIMO_API_KEY}"
+      }
+    }
+  }
+}
+```
+
+## 配置
+
+| 环境变量 | 必填 | 默认值 | 说明 |
+|----------|------|--------|------|
+| `MIMO_API_KEY` | ✅ | — | MiMo 平台 API Key |
+| `MIMO_BASE_URL` | ❌ | `https://api.xiaomimimo.com/v1` | 自定义 API 端点 |
+| `MIMO_MODEL` | ❌ | `mimo-v2-omni` | 默认模型 |
+| `MIMO_MAX_TOKENS` | ❌ | `4096` | 单次最大输出 token |
+
+## 工具详情
+
+### describe_image
+
+对任意图片进行内容描述。
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| `image_path` | string | ✅ | — | 本地文件绝对路径或 HTTP/HTTPS URL |
+| `prompt` | string | ❌ | `"请详细描述这张图片的内容"` | 自定义分析指令 |
+
+### ocr_image
+
+从图片中提取文字。
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| `image_path` | string | ✅ | — | 图片路径或 URL |
+| `language` | string | ❌ | `"zh"` | 偏好语言：`zh`/`en`/`ja`/`ko`/`auto` |
+
+### compare_images
+
+对比两张图片的异同。
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| `image1` | string | ✅ | — | 第一张图片路径/URL |
+| `image2` | string | ✅ | — | 第二张图片路径/URL |
+| `aspect` | string | ❌ | `"general"` | 对比维度：`general`/`differences`/`similarity`/`which_is_better` |
+
+### analyze_screenshot
+
+分析 UI 截图。
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| `image_path` | string | ✅ | — | 截图路径/URL |
+| `focus` | string | ❌ | `"all"` | 分析焦点：`layout`/`usability`/`accessibility`/`all` |
+
+## 开发
+
+```bash
+# 安装依赖
+npm install
+
+# 编译
+npm run build
+
+# 测试
+npm test
+
+# 开发模式（监听编译）
+npm run dev
+```
+
+## 许可证
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,43 @@
+/**
+ * MiMo API 客户端 — 封装 OpenAI SDK 实例，提供统一的视觉 API 调用接口
+ *
+ * MiMo API 完全兼容 OpenAI chat/completions 格式，
+ * 因此可以直接使用 OpenAI SDK 进行调用。
+ */
+/** 视觉 API 调用参数 */
+export interface VisionRequest {
+    /** 用户提示词 */
+    prompt: string;
+    /** 图片 URL（支持 https:// URL 或 data: URL） */
+    imageUrl: string;
+    /** 可选：第二张图片 URL（用于对比） */
+    imageUrl2?: string;
+    /** 可选：覆盖默认模型 */
+    model?: string;
+    /** 可选：覆盖默认 max_tokens */
+    maxTokens?: number;
+}
+/** 视觉 API 返回结果 */
+export interface VisionResponse {
+    /** AI 生成的文本内容 */
+    content: string;
+    /** 实际使用的模型名 */
+    model: string;
+    /** 消耗的 token 数 */
+    tokens: number;
+}
+/**
+ * 调用 MiMo Vision API
+ *
+ * 错误处理：
+ * - 401 → 认证失败
+ * - 429 → 配额耗尽
+ * - 5xx → 服务异常
+ * - 超时 → 超时错误
+ * - 网络错误 → 连接失败
+ *
+ * @param request - 视觉 API 调用参数
+ * @returns AI 生成的响应
+ */
+export declare function callVision(request: VisionRequest): Promise<VisionResponse>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,kBAAkB;AAClB,MAAM,WAAW,aAAa;IAC5B,YAAY;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,kBAAkB;AAClB,MAAM,WAAW,cAAc;IAC7B,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe;IACf,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAsBD;;;;;;;;;;;;GAYG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,cAAc,CAAC,CAmGzB"}

package/dist/client.js

@@ -0,0 +1,114 @@
+/**
+ * MiMo API 客户端 — 封装 OpenAI SDK 实例，提供统一的视觉 API 调用接口
+ *
+ * MiMo API 完全兼容 OpenAI chat/completions 格式，
+ * 因此可以直接使用 OpenAI SDK 进行调用。
+ */
+import OpenAI from "openai";
+import { getConfig } from "./utils/config.js";
+/** 请求超时时间（毫秒） */
+const TIMEOUT_MS = 30_000;
+/**
+ * 创建 OpenAI 客户端实例（懒加载单例）
+ */
+let _client = null;
+let _config = null;
+function getClient() {
+    const config = getConfig();
+    // 配置变更时重新创建客户端
+    if (!_client || _config?.apiKey !== config.apiKey || _config?.baseUrl !== config.baseUrl) {
+        _config = config;
+        _client = new OpenAI({
+            apiKey: config.apiKey,
+            baseURL: config.baseUrl,
+            timeout: TIMEOUT_MS,
+        });
+    }
+    return _client;
+}
+/**
+ * 调用 MiMo Vision API
+ *
+ * 错误处理：
+ * - 401 → 认证失败
+ * - 429 → 配额耗尽
+ * - 5xx → 服务异常
+ * - 超时 → 超时错误
+ * - 网络错误 → 连接失败
+ *
+ * @param request - 视觉 API 调用参数
+ * @returns AI 生成的响应
+ */
+export async function callVision(request) {
+    const config = getConfig();
+    const client = getClient();
+    const model = request.model || config.model;
+    const maxTokens = request.maxTokens || config.maxTokens;
+    // 构造消息内容（OpenAI Vision 格式）
+    const content = [
+        { type: "text", text: request.prompt },
+        {
+            type: "image_url",
+            image_url: { url: request.imageUrl },
+        },
+    ];
+    // 第二张图片（用于对比场景）
+    if (request.imageUrl2) {
+        content.push({
+            type: "image_url",
+            image_url: { url: request.imageUrl2 },
+        });
+    }
+    try {
+        const response = await client.chat.completions.create({
+            model,
+            messages: [
+                {
+                    role: "user",
+                    content,
+                },
+            ],
+            max_tokens: maxTokens,
+        });
+        const choice = response.choices[0];
+        if (!choice?.message?.content) {
+            throw new Error("MiMo API 返回了空响应");
+        }
+        return {
+            content: choice.message.content,
+            model: response.model || model,
+            tokens: response.usage?.total_tokens || 0,
+        };
+    }
+    catch (error) {
+        // 处理 OpenAI SDK 抛出的错误
+        if (error && typeof error === "object") {
+            const apiError = error;
+            // HTTP 状态错误
+            if (apiError.status === 401) {
+                throw new Error("认证失败，请检查 MIMO_API_KEY 环境变量是否正确");
+            }
+            if (apiError.status === 429) {
+                throw new Error("API 配额已耗尽，请稍后重试或检查账户余额");
+            }
+            if (apiError.status && apiError.status >= 500) {
+                throw new Error(`MiMo API 服务异常 (状态码: ${apiError.status})，请稍后重试`);
+            }
+            // 网络/超时错误
+            if (apiError.code === "ETIMEDOUT" ||
+                apiError.code === "ECONNABORTED" ||
+                apiError.name === "APIConnectionTimeoutError") {
+                throw new Error("请求超时（30秒），请重试或尝试更小的图片");
+            }
+            if (apiError.code === "ENOTFOUND" ||
+                apiError.code === "ECONNREFUSED" ||
+                apiError.name === "APIConnectionError") {
+                throw new Error(`无法连接到 MiMo API: ${apiError.message || "网络连接失败"}`);
+            }
+        }
+        // 通用未知错误
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`未知错误: ${message}`);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAe,MAAM,mBAAmB,CAAC;AAE3D,iBAAiB;AACjB,MAAM,UAAU,GAAG,MAAM,CAAC;AA0B1B;;GAEG;AACH,IAAI,OAAO,GAAkB,IAAI,CAAC;AAClC,IAAI,OAAO,GAAkB,IAAI,CAAC;AAElC,SAAS,SAAS;IAChB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,eAAe;IACf,IAAI,CAAC,OAAO,IAAI,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,IAAI,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC;QACzF,OAAO,GAAG,MAAM,CAAC;QACjB,OAAO,GAAG,IAAI,MAAM,CAAC;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO,EAAE,UAAU;SACpB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAAsB;IAEtB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC;IAC5C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC;IAExD,2BAA2B;IAC3B,MAAM,OAAO,GAA4C;QACvD,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE;QACtC;YACE,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ,EAAE;SACrC;KACF,CAAC;IAEF,gBAAgB;IAChB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,SAAS,EAAE;SACtC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;YACpD,KAAK;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO;iBACR;aACF;YACD,UAAU,EAAE,SAAS;SACtB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACrC,CAAC;QAED,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO;YAC/B,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,KAAK;YAC9B,MAAM,EAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC;SAC1C,CAAC;IACJ,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,sBAAsB;QACtB,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvC,MAAM,QAAQ,GAAG,KAKhB,CAAC;YAEF,YAAY;YACZ,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CACb,gCAAgC,CACjC,CAAC;YACJ,CAAC;YACD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CACb,wBAAwB,CACzB,CAAC;YACJ,CAAC;YACD,IAAI,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;gBAC9C,MAAM,IAAI,KAAK,CACb,uBAAuB,QAAQ,CAAC,MAAM,SAAS,CAChD,CAAC;YACJ,CAAC;YAED,UAAU;YACV,IACE,QAAQ,CAAC,IAAI,KAAK,WAAW;gBAC7B,QAAQ,CAAC,IAAI,KAAK,cAAc;gBAChC,QAAQ,CAAC,IAAI,KAAK,2BAA2B,EAC7C,CAAC;gBACD,MAAM,IAAI,KAAK,CACb,uBAAuB,CACxB,CAAC;YACJ,CAAC;YACD,IACE,QAAQ,CAAC,IAAI,KAAK,WAAW;gBAC7B,QAAQ,CAAC,IAAI,KAAK,cAAc;gBAChC,QAAQ,CAAC,IAAI,KAAK,oBAAoB,EACtC,CAAC;gBACD,MAAM,IAAI,KAAK,CACb,mBAAmB,QAAQ,CAAC,OAAO,IAAI,QAAQ,EAAE,CAClD,CAAC;YACJ,CAAC;QACH,CAAC;QAED,SAAS;QACT,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * MiMo Vision MCP Server — 入口文件
+ *
+ * 启动 MCP Server，注册 4 个视觉工具：
+ * - describe_image: 通用图片描述
+ * - ocr_image: OCR 文字提取
+ * - compare_images: 双图对比分析
+ * - analyze_screenshot: 截图/UI 分析
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG"}

package/dist/index.js

@@ -0,0 +1,173 @@
+#!/usr/bin/env node
+/**
+ * MiMo Vision MCP Server — 入口文件
+ *
+ * 启动 MCP Server，注册 4 个视觉工具：
+ * - describe_image: 通用图片描述
+ * - ocr_image: OCR 文字提取
+ * - compare_images: 双图对比分析
+ * - analyze_screenshot: 截图/UI 分析
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { getConfig } from "./utils/config.js";
+import { isUrl, imageToBase64 } from "./utils/image.js";
+import { callVision } from "./client.js";
+import { describeImageParams } from "./tools/describe-image.js";
+import { ocrImageParams, buildOcrPrompt, } from "./tools/ocr-image.js";
+import { compareImagesParams, buildComparePrompt, } from "./tools/compare-images.js";
+import { analyzeScreenshotParams, buildScreenshotPrompt, } from "./tools/analyze-screenshot.js";
+// 启动时验证配置
+try {
+    getConfig();
+}
+catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`[MiMo MCP] 配置错误: ${message}`);
+    process.exit(1);
+}
+const server = new McpServer({
+    name: "mimo-vision-mcp",
+    version: "1.0.0",
+});
+/**
+ * 解析图片输入为 vision API 可用的 URL
+ * - URL → 直接返回
+ * - 本地路径 → 转为 base64 data URL
+ */
+async function resolveImageUrl(imagePath) {
+    if (isUrl(imagePath)) {
+        return imagePath;
+    }
+    const { dataUrl } = await imageToBase64(imagePath);
+    return dataUrl;
+}
+// ========== Tool 1: describe_image ==========
+server.tool("describe_image", "通用图片描述 — 对任意图片进行内容描述，支持自定义提示词。输入可以是本地文件路径或 HTTP/HTTPS URL。", describeImageParams.shape, async ({ image_path, prompt }) => {
+    try {
+        const imageUrl = await resolveImageUrl(image_path);
+        const result = await callVision({
+            prompt: `你是一个专业的图片分析助手。${prompt}`,
+            imageUrl,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        description: result.content,
+                        model: result.model,
+                        tokens: result.tokens,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `错误: ${message}` }],
+            isError: true,
+        };
+    }
+});
+// ========== Tool 2: ocr_image ==========
+server.tool("ocr_image", "OCR 文字提取 — 从图片中提取文字，支持指定语言偏好 (zh/en/ja/ko/auto)。", ocrImageParams.shape, async ({ image_path, language }) => {
+    try {
+        const imageUrl = await resolveImageUrl(image_path);
+        const result = await callVision({
+            prompt: buildOcrPrompt(language),
+            imageUrl,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        text: result.content,
+                        language,
+                        model: result.model,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `错误: ${message}` }],
+            isError: true,
+        };
+    }
+});
+// ========== Tool 3: compare_images ==========
+server.tool("compare_images", "双图对比分析 — 对比两张图片的异同，支持多种对比维度 (general/differences/similarity/which_is_better)。", compareImagesParams.shape, async ({ image1, image2, aspect }) => {
+    try {
+        const [imageUrl1, imageUrl2] = await Promise.all([
+            resolveImageUrl(image1),
+            resolveImageUrl(image2),
+        ]);
+        const result = await callVision({
+            prompt: buildComparePrompt(aspect),
+            imageUrl: imageUrl1,
+            imageUrl2: imageUrl2,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        comparison: result.content,
+                        model: result.model,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `错误: ${message}` }],
+            isError: true,
+        };
+    }
+});
+// ========== Tool 4: analyze_screenshot ==========
+server.tool("analyze_screenshot", "截图/UI 分析 — 分析 UI 截图的布局、可用性、可访问性，给出改进建议。支持指定分析焦点 (layout/usability/accessibility/all)。", analyzeScreenshotParams.shape, async ({ image_path, focus }) => {
+    try {
+        const imageUrl = await resolveImageUrl(image_path);
+        const result = await callVision({
+            prompt: buildScreenshotPrompt(focus),
+            imageUrl,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        analysis: result.content,
+                        model: result.model,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `错误: ${message}` }],
+            isError: true,
+        };
+    }
+});
+// 启动服务器
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[MiMo MCP] 服务器已启动");
+}
+main().catch((error) => {
+    console.error("[MiMo MCP] 启动失败:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/analyze-screenshot.d.ts

@@ -0,0 +1,26 @@
+/**
+ * analyze_screenshot 工具 — 截图/UI 结构分析
+ *
+ * 分析 UI 截图，评估布局/可用性/可访问性等维度。
+ */
+import { z } from "zod";
+/** analyze_screenshot 工具的参数 schema */
+export declare const analyzeScreenshotParams: z.ZodObject<{
+    /** 截图路径或 URL */
+    image_path: z.ZodString;
+    /** 分析重点 */
+    focus: z.ZodDefault<z.ZodOptional<z.ZodEnum<["layout", "usability", "accessibility", "all"]>>>;
+}, "strip", z.ZodTypeAny, {
+    image_path: string;
+    focus: "layout" | "usability" | "accessibility" | "all";
+}, {
+    image_path: string;
+    focus?: "layout" | "usability" | "accessibility" | "all" | undefined;
+}>;
+/** 参数类型 */
+export type AnalyzeScreenshotParams = z.infer<typeof analyzeScreenshotParams>;
+/**
+ * 构造 UI 分析提示词
+ */
+export declare function buildScreenshotPrompt(focus: string): string;
+//# sourceMappingURL=analyze-screenshot.d.ts.map

package/dist/tools/analyze-screenshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-screenshot.d.ts","sourceRoot":"","sources":["../../src/tools/analyze-screenshot.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,sCAAsC;AACtC,eAAO,MAAM,uBAAuB;IAClC,gBAAgB;;IAIhB,WAAW;;;;;;;;EAKX,CAAC;AAEH,WAAW;AACX,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAU9E;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG3D"}

package/dist/tools/analyze-screenshot.js

@@ -0,0 +1,35 @@
+/**
+ * analyze_screenshot 工具 — 截图/UI 结构分析
+ *
+ * 分析 UI 截图，评估布局/可用性/可访问性等维度。
+ */
+import { z } from "zod";
+/** 分析焦点 */
+const FOCUS_AREAS = ["layout", "usability", "accessibility", "all"];
+/** analyze_screenshot 工具的参数 schema */
+export const analyzeScreenshotParams = z.object({
+    /** 截图路径或 URL */
+    image_path: z
+        .string()
+        .min(1, "请提供截图路径或 URL"),
+    /** 分析重点 */
+    focus: z
+        .enum(FOCUS_AREAS)
+        .optional()
+        .default("all"),
+});
+/** 分析焦点中文映射 */
+const FOCUS_LABELS = {
+    layout: "布局结构",
+    usability: "可用性",
+    accessibility: "可访问性",
+    all: "布局、可用性、可访问性",
+};
+/**
+ * 构造 UI 分析提示词
+ */
+export function buildScreenshotPrompt(focus) {
+    const focusLabel = FOCUS_LABELS[focus] || focus;
+    return `你是一个专业的 UI/UX 分析专家。请对这张截图进行${focusLabel}方面的分析，给出具体、可操作的改进建议。`;
+}
+//# sourceMappingURL=analyze-screenshot.js.map

package/dist/tools/analyze-screenshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-screenshot.js","sourceRoot":"","sources":["../../src/tools/analyze-screenshot.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,WAAW;AACX,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,KAAK,CAAU,CAAC;AAE7E,sCAAsC;AACtC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,gBAAgB;IAChB,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC;IACzB,WAAW;IACX,KAAK,EAAE,CAAC;SACL,IAAI,CAAC,WAAW,CAAC;SACjB,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;CAClB,CAAC,CAAC;AAKH,eAAe;AACf,MAAM,YAAY,GAA2B;IAC3C,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,KAAK;IAChB,aAAa,EAAE,MAAM;IACrB,GAAG,EAAE,aAAa;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;IAChD,OAAO,8BAA8B,UAAU,sBAAsB,CAAC;AACxE,CAAC"}

package/dist/tools/compare-images.d.ts

@@ -0,0 +1,30 @@
+/**
+ * compare_images 工具 — 双图对比分析
+ *
+ * 对比两张图片的异同，支持从不同维度进行分析。
+ */
+import { z } from "zod";
+/** compare_images 工具的参数 schema */
+export declare const compareImagesParams: z.ZodObject<{
+    /** 第一张图片路径或 URL */
+    image1: z.ZodString;
+    /** 第二张图片路径或 URL */
+    image2: z.ZodString;
+    /** 对比维度 */
+    aspect: z.ZodDefault<z.ZodOptional<z.ZodEnum<["general", "differences", "similarity", "which_is_better"]>>>;
+}, "strip", z.ZodTypeAny, {
+    image1: string;
+    image2: string;
+    aspect: "general" | "differences" | "similarity" | "which_is_better";
+}, {
+    image1: string;
+    image2: string;
+    aspect?: "general" | "differences" | "similarity" | "which_is_better" | undefined;
+}>;
+/** 参数类型 */
+export type CompareImagesParams = z.infer<typeof compareImagesParams>;
+/**
+ * 构造对比分析提示词
+ */
+export declare function buildComparePrompt(aspect: string): string;
+//# sourceMappingURL=compare-images.d.ts.map

package/dist/tools/compare-images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-images.d.ts","sourceRoot":"","sources":["../../src/tools/compare-images.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,kCAAkC;AAClC,eAAO,MAAM,mBAAmB;IAC9B,mBAAmB;;IAInB,mBAAmB;;IAInB,WAAW;;;;;;;;;;EAKX,CAAC;AAEH,WAAW;AACX,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAUtE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGzD"}

package/dist/tools/compare-images.js

@@ -0,0 +1,39 @@
+/**
+ * compare_images 工具 — 双图对比分析
+ *
+ * 对比两张图片的异同，支持从不同维度进行分析。
+ */
+import { z } from "zod";
+/** 对比维度 */
+const ASPECTS = ["general", "differences", "similarity", "which_is_better"];
+/** compare_images 工具的参数 schema */
+export const compareImagesParams = z.object({
+    /** 第一张图片路径或 URL */
+    image1: z
+        .string()
+        .min(1, "请提供第一张图片的路径或 URL"),
+    /** 第二张图片路径或 URL */
+    image2: z
+        .string()
+        .min(1, "请提供第二张图片的路径或 URL"),
+    /** 对比维度 */
+    aspect: z
+        .enum(ASPECTS)
+        .optional()
+        .default("general"),
+});
+/** 对比维度中文映射 */
+const ASPECT_LABELS = {
+    general: "综合",
+    differences: "差异点",
+    similarity: "相似点",
+    which_is_better: "优劣对比",
+};
+/**
+ * 构造对比分析提示词
+ */
+export function buildComparePrompt(aspect) {
+    const aspectLabel = ASPECT_LABELS[aspect] || aspect;
+    return `你是一个专业的图片对比分析助手。请对比以下两张图片，从「${aspectLabel}」角度进行详细分析。`;
+}
+//# sourceMappingURL=compare-images.js.map

package/dist/tools/compare-images.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-images.js","sourceRoot":"","sources":["../../src/tools/compare-images.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,WAAW;AACX,MAAM,OAAO,GAAG,CAAC,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,iBAAiB,CAAU,CAAC;AAErF,kCAAkC;AAClC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,mBAAmB;IACnB,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,kBAAkB,CAAC;IAC7B,mBAAmB;IACnB,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,kBAAkB,CAAC;IAC7B,WAAW;IACX,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,OAAO,CAAC;SACb,QAAQ,EAAE;SACV,OAAO,CAAC,SAAS,CAAC;CACtB,CAAC,CAAC;AAKH,eAAe;AACf,MAAM,aAAa,GAA2B;IAC5C,OAAO,EAAE,IAAI;IACb,WAAW,EAAE,KAAK;IAClB,UAAU,EAAE,KAAK;IACjB,eAAe,EAAE,MAAM;CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC;IACpD,OAAO,+BAA+B,WAAW,YAAY,CAAC;AAChE,CAAC"}

package/dist/tools/describe-image.d.ts

@@ -0,0 +1,23 @@
+/**
+ * describe_image 工具 — 通用图片描述
+ *
+ * 对任意图片进行内容描述，支持自定义提示词。
+ * 输入支持本地文件路径或远程 URL。
+ */
+import { z } from "zod";
+/** describe_image 工具的参数 schema */
+export declare const describeImageParams: z.ZodObject<{
+    /** 本地文件绝对路径或 HTTP/HTTPS URL */
+    image_path: z.ZodString;
+    /** 自定义分析指令 */
+    prompt: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    image_path: string;
+    prompt: string;
+}, {
+    image_path: string;
+    prompt?: string | undefined;
+}>;
+/** 参数类型 */
+export type DescribeImageParams = z.infer<typeof describeImageParams>;
+//# sourceMappingURL=describe-image.d.ts.map

package/dist/tools/describe-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-image.d.ts","sourceRoot":"","sources":["../../src/tools/describe-image.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,kCAAkC;AAClC,eAAO,MAAM,mBAAmB;IAC9B,+BAA+B;;IAI/B,cAAc;;;;;;;;EAKd,CAAC;AAEH,WAAW;AACX,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/tools/describe-image.js

@@ -0,0 +1,20 @@
+/**
+ * describe_image 工具 — 通用图片描述
+ *
+ * 对任意图片进行内容描述，支持自定义提示词。
+ * 输入支持本地文件路径或远程 URL。
+ */
+import { z } from "zod";
+/** describe_image 工具的参数 schema */
+export const describeImageParams = z.object({
+    /** 本地文件绝对路径或 HTTP/HTTPS URL */
+    image_path: z
+        .string()
+        .min(1, "请提供图片路径或 URL"),
+    /** 自定义分析指令 */
+    prompt: z
+        .string()
+        .optional()
+        .default("请详细描述这张图片的内容"),
+});
+//# sourceMappingURL=describe-image.js.map

package/dist/tools/describe-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-image.js","sourceRoot":"","sources":["../../src/tools/describe-image.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,kCAAkC;AAClC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,+BAA+B;IAC/B,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC;IACzB,cAAc;IACd,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,OAAO,CAAC,cAAc,CAAC;CAC3B,CAAC,CAAC"}

package/dist/tools/ocr-image.d.ts

@@ -0,0 +1,27 @@
+/**
+ * ocr_image 工具 — 文字提取
+ *
+ * 从图片中提取文字，支持指定语言偏好。
+ * 模型会被引导只输出提取到的文字，不添加额外说明。
+ */
+import { z } from "zod";
+/** ocr_image 工具的参数 schema */
+export declare const ocrImageParams: z.ZodObject<{
+    /** 本地文件绝对路径或 HTTP/HTTPS URL */
+    image_path: z.ZodString;
+    /** 偏好语言 */
+    language: z.ZodDefault<z.ZodOptional<z.ZodEnum<["zh", "en", "ja", "ko", "auto"]>>>;
+}, "strip", z.ZodTypeAny, {
+    image_path: string;
+    language: "zh" | "en" | "ja" | "ko" | "auto";
+}, {
+    image_path: string;
+    language?: "zh" | "en" | "ja" | "ko" | "auto" | undefined;
+}>;
+/** 参数类型 */
+export type OcrImageParams = z.infer<typeof ocrImageParams>;
+/**
+ * 构造 OCR 专用的系统提示词
+ */
+export declare function buildOcrPrompt(language: string): string;
+//# sourceMappingURL=ocr-image.d.ts.map

package/dist/tools/ocr-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ocr-image.d.ts","sourceRoot":"","sources":["../../src/tools/ocr-image.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,6BAA6B;AAC7B,eAAO,MAAM,cAAc;IACzB,+BAA+B;;IAI/B,WAAW;;;;;;;;EAKX,CAAC;AAEH,WAAW;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAW5D;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGvD"}

package/dist/tools/ocr-image.js

@@ -0,0 +1,37 @@
+/**
+ * ocr_image 工具 — 文字提取
+ *
+ * 从图片中提取文字，支持指定语言偏好。
+ * 模型会被引导只输出提取到的文字，不添加额外说明。
+ */
+import { z } from "zod";
+/** 支持的语言 */
+const SUPPORTED_LANGUAGES = ["zh", "en", "ja", "ko", "auto"];
+/** ocr_image 工具的参数 schema */
+export const ocrImageParams = z.object({
+    /** 本地文件绝对路径或 HTTP/HTTPS URL */
+    image_path: z
+        .string()
+        .min(1, "请提供图片路径或 URL"),
+    /** 偏好语言 */
+    language: z
+        .enum(SUPPORTED_LANGUAGES)
+        .optional()
+        .default("zh"),
+});
+/** 语言中文名映射 */
+const LANGUAGE_LABELS = {
+    zh: "中文",
+    en: "英文",
+    ja: "日文",
+    ko: "韩文",
+    auto: "所有",
+};
+/**
+ * 构造 OCR 专用的系统提示词
+ */
+export function buildOcrPrompt(language) {
+    const langLabel = LANGUAGE_LABELS[language] || language;
+    return `请提取这张图片中的所有文字，优先识别${langLabel}文字。只输出提取到的文字，不要添加额外说明。`;
+}
+//# sourceMappingURL=ocr-image.js.map

package/dist/tools/ocr-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ocr-image.js","sourceRoot":"","sources":["../../src/tools/ocr-image.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,YAAY;AACZ,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAU,CAAC;AAEtE,6BAA6B;AAC7B,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,+BAA+B;IAC/B,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC;IACzB,WAAW;IACX,QAAQ,EAAE,CAAC;SACR,IAAI,CAAC,mBAAmB,CAAC;SACzB,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;CACjB,CAAC,CAAC;AAKH,cAAc;AACd,MAAM,eAAe,GAA2B;IAC9C,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,IAAI,EAAE,IAAI;CACX,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,MAAM,SAAS,GAAG,eAAe,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC;IACxD,OAAO,qBAAqB,SAAS,wBAAwB,CAAC;AAChE,CAAC"}

package/dist/tools/tool-types.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 工具类型定义 — 所有工具共享的类型
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** 工具处理函数结果 */
+export interface ToolHandlerResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}
+/** 在 MCP Server 上注册工具的函数类型 */
+export type ToolRegistrar = (server: McpServer) => void;
+//# sourceMappingURL=tool-types.d.ts.map

package/dist/tools/tool-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-types.d.ts","sourceRoot":"","sources":["../../src/tools/tool-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,eAAe;AACf,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED,8BAA8B;AAC9B,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC"}

package/dist/tools/tool-types.js

@@ -0,0 +1,5 @@
+/**
+ * 工具类型定义 — 所有工具共享的类型
+ */
+export {};
+//# sourceMappingURL=tool-types.js.map

package/dist/tools/tool-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-types.js","sourceRoot":"","sources":["../../src/tools/tool-types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/config.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 配置模块 — 从环境变量读取结构化配置
+ *
+ * 优先级：环境变量 > 默认值
+ * 仅 MIMO_API_KEY 为必填项
+ */
+export interface Config {
+    /** MiMo 平台 API Key */
+    apiKey: string;
+    /** MiMo API 端点 */
+    baseUrl: string;
+    /** 默认使用的视觉模型 */
+    model: string;
+    /** 单次请求最大输出 token 数 */
+    maxTokens: number;
+}
+/**
+ * 从环境变量读取配置
+ * @throws {Error} 当 MIMO_API_KEY 未设置时抛出
+ */
+export declare function getConfig(): Config;
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,MAAM;IACrB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAuBlC"}

package/dist/utils/config.js

@@ -0,0 +1,28 @@
+/**
+ * 配置模块 — 从环境变量读取结构化配置
+ *
+ * 优先级：环境变量 > 默认值
+ * 仅 MIMO_API_KEY 为必填项
+ */
+/**
+ * 从环境变量读取配置
+ * @throws {Error} 当 MIMO_API_KEY 未设置时抛出
+ */
+export function getConfig() {
+    const apiKey = process.env.MIMO_API_KEY;
+    if (!apiKey) {
+        throw new Error("请设置 MIMO_API_KEY 环境变量。示例: export MIMO_API_KEY=your-key");
+    }
+    const baseUrl = process.env.MIMO_BASE_URL || "https://api.xiaomimimo.com/v1";
+    const model = process.env.MIMO_MODEL || "mimo-v2-omni";
+    const maxTokensRaw = process.env.MIMO_MAX_TOKENS;
+    let maxTokens = 4096;
+    if (maxTokensRaw) {
+        const parsed = parseInt(maxTokensRaw, 10);
+        if (!isNaN(parsed) && parsed > 0) {
+            maxTokens = parsed;
+        }
+    }
+    return { apiKey, baseUrl, model, maxTokens };
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH;;;GAGG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IACxC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,wDAAwD,CACzD,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GACX,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,+BAA+B,CAAC;IAE/D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,cAAc,CAAC;IAEvD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IACjD,IAAI,SAAS,GAAG,IAAI,CAAC;IACrB,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,SAAS,GAAG,MAAM,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC/C,CAAC"}

package/dist/utils/image.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 图片工具模块 — 本地图片路径判断、格式检测、base64 编码
+ *
+ * 职责：
+ * - 判断输入是本地路径还是远程 URL
+ * - 通过文件扩展名检测 MIME 类型
+ * - 将本地图片转为 base64 data URL（检查大小限制）
+ */
+/** 最大文件大小：10MB */
+export declare const MAX_FILE_SIZE: number;
+/** 支持的格式列表 */
+export declare const SUPPORTED_FORMATS: string[];
+/**
+ * 判断字符串是否为 HTTP/HTTPS URL
+ */
+export declare function isUrl(str: string): boolean;
+/**
+ * 判断字符串是否为本地文件路径（非 URL）
+ */
+export declare function isLocalFile(str: string): boolean;
+/**
+ * 根据文件扩展名获取 MIME 类型
+ * @param ext - 扩展名（不含点号，如 "png"）
+ * @returns MIME 类型字符串，不支持的格式返回 null
+ */
+export declare function getMimeType(ext: string): string | null;
+/**
+ * 将本地图片文件转为 base64 data URL
+ *
+ * 处理流程：
+ * 1. 检查文件是否存在
+ * 2. 检查格式是否支持
+ * 3. 检查文件大小是否超过 10MB
+ * 4. 读取文件并编码为 base64
+ *
+ * @param filePath - 图片文件的绝对路径
+ * @returns base64 data URL 和 MIME 类型
+ * @throws {Error} 文件不存在 / 格式不支持 / 超出大小限制
+ */
+export declare function imageToBase64(filePath: string): Promise<{
+    dataUrl: string;
+    mimeType: string;
+}>;
+//# sourceMappingURL=image.d.ts.map

package/dist/utils/image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../src/utils/image.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH,kBAAkB;AAClB,eAAO,MAAM,aAAa,QAAmB,CAAC;AAE9C,cAAc;AACd,eAAO,MAAM,iBAAiB,UAAwB,CAAC;AAEvD;;GAEG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE1C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEtD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAgChD"}

package/dist/utils/image.js

@@ -0,0 +1,80 @@
+/**
+ * 图片工具模块 — 本地图片路径判断、格式检测、base64 编码
+ *
+ * 职责：
+ * - 判断输入是本地路径还是远程 URL
+ * - 通过文件扩展名检测 MIME 类型
+ * - 将本地图片转为 base64 data URL（检查大小限制）
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+/** 支持的图片格式及其 MIME 类型 */
+const MIME_MAP = {
+    png: "image/png",
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    gif: "image/gif",
+    webp: "image/webp",
+    bmp: "image/bmp",
+};
+/** 最大文件大小：10MB */
+export const MAX_FILE_SIZE = 10 * 1024 * 1024;
+/** 支持的格式列表 */
+export const SUPPORTED_FORMATS = Object.keys(MIME_MAP);
+/**
+ * 判断字符串是否为 HTTP/HTTPS URL
+ */
+export function isUrl(str) {
+    return /^https?:\/\//i.test(str);
+}
+/**
+ * 判断字符串是否为本地文件路径（非 URL）
+ */
+export function isLocalFile(str) {
+    return !isUrl(str);
+}
+/**
+ * 根据文件扩展名获取 MIME 类型
+ * @param ext - 扩展名（不含点号，如 "png"）
+ * @returns MIME 类型字符串，不支持的格式返回 null
+ */
+export function getMimeType(ext) {
+    return MIME_MAP[ext.toLowerCase()] ?? null;
+}
+/**
+ * 将本地图片文件转为 base64 data URL
+ *
+ * 处理流程：
+ * 1. 检查文件是否存在
+ * 2. 检查格式是否支持
+ * 3. 检查文件大小是否超过 10MB
+ * 4. 读取文件并编码为 base64
+ *
+ * @param filePath - 图片文件的绝对路径
+ * @returns base64 data URL 和 MIME 类型
+ * @throws {Error} 文件不存在 / 格式不支持 / 超出大小限制
+ */
+export async function imageToBase64(filePath) {
+    // 1. 检查文件是否存在
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`文件未找到: ${filePath}，请检查路径是否正确`);
+    }
+    // 2. 检查格式
+    const ext = path.extname(filePath).replace(/^\./, "");
+    const mimeType = getMimeType(ext);
+    if (!mimeType) {
+        throw new Error(`不支持的图片格式: .${ext || "(无扩展名)"}，支持: ${SUPPORTED_FORMATS.map((f) => f.toUpperCase()).join(", ")}`);
+    }
+    // 3. 检查大小
+    const stat = fs.statSync(filePath);
+    if (stat.size > MAX_FILE_SIZE) {
+        const sizeMB = (stat.size / (1024 * 1024)).toFixed(1);
+        throw new Error(`图片大小 ${sizeMB}MB 超过 ${MAX_FILE_SIZE / (1024 * 1024)}MB 限制，请压缩后重试`);
+    }
+    // 4. 读取并编码
+    const buffer = fs.readFileSync(filePath);
+    const base64 = buffer.toString("base64");
+    const dataUrl = `data:${mimeType};base64,${base64}`;
+    return { dataUrl, mimeType };
+}
+//# sourceMappingURL=image.js.map

package/dist/utils/image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../../src/utils/image.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,wBAAwB;AACxB,MAAM,QAAQ,GAA2B;IACvC,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,YAAY;IACjB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,WAAW;IAChB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,WAAW;CACjB,CAAC;AAEF,kBAAkB;AAClB,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAE9C,cAAc;AACd,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAEvD;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,GAAW;IAC/B,OAAO,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,IAAI,CAAC;AAC7C,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAgB;IAEhB,cAAc;IACd,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,UAAU,QAAQ,YAAY,CAC/B,CAAC;IACJ,CAAC;IAED,UAAU;IACV,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,cAAc,GAAG,IAAI,QAAQ,QAAQ,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAChG,CAAC;IACJ,CAAC;IAED,UAAU;IACV,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,IAAI,GAAG,aAAa,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACtD,MAAM,IAAI,KAAK,CACb,QAAQ,MAAM,SAAS,aAAa,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,cAAc,CACnE,CAAC;IACJ,CAAC;IAED,WAAW;IACX,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,QAAQ,QAAQ,WAAW,MAAM,EAAE,CAAC;IAEpD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "mimo-vision-claude",
+  "version": "1.0.0",
+  "description": "MiMo Vision MCP Server — 封装小米 MiMo 全模态大模型视觉 API，为 Claude Code 提供识图能力",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "mimo-vision-claude": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "mimo",
+    "vision",
+    "ai",
+    "claude"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "openai": "^4.73.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}