luma-mcp 1.0.2 → 1.1.0

package/.env.example

@@ -0,0 +1,39 @@
+# Luma MCP 配置示例
+
+# ==========================================
+# 模型提供商选择
+# ==========================================
+# 可选值: zhipu, siliconflow
+# 默认: zhipu
+MODEL_PROVIDER=zhipu
+
+# ==========================================
+# 智谱 GLM-4.5V 配置（使用智谱时需要）
+# ==========================================
+ZHIPU_API_KEY=your-zhipu-api-key-here
+
+# ==========================================
+# 硅基流动 DeepSeek-OCR 配置（使用硅基流动时需要）
+# ==========================================
+# SILICONFLOW_API_KEY=your-siliconflow-api-key-here
+
+# ==========================================
+# 通用配置（可选）
+# ==========================================
+# 模型名称（留空则使用默认值）
+# zhipu 默认: glm-4.5v
+# siliconflow 默认: deepseek-ai/DeepSeek-OCR
+# MODEL_NAME=
+
+# 最大生成 tokens（默认: 4096）
+# MAX_TOKENS=4096
+
+# 温度参数 0-1（默认: 0.7）
+# TEMPERATURE=0.7
+
+# Top-p 参数 0-1（默认: 0.7）
+# TOP_P=0.7
+
+# 是否启用思考模式（仅 GLM-4.5V 支持，默认: false）
+# 启用后可提高分析准确性，但会增加 20-30% tokens 消耗
+# ENABLE_THINKING=false

package/CHANGELOG.md

@@ -0,0 +1,50 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [1.1.0] - 2025-11-13
+
+### Added
+- 🎉 **多模型支持**: 新增硅基流动 DeepSeek-OCR 支持
+- 🆓 **免费选项**: DeepSeek-OCR 通过硅基流动提供完全免费的 OCR 服务
+- 📐 **统一接口**: 创建 VisionClient 接口，支持灵活扩展更多视觉模型
+- ⚙️ **灵活配置**: 通过 `MODEL_PROVIDER` 环境变量轻松切换模型
+
+### Changed
+- 🔧 环境变量命名优化，支持通用配置（`MODEL_NAME`、`MAX_TOKENS` 等）
+- 📝 更新文档，提供双模型配置说明和选择建议
+- 🏗️ 重构代码结构，提升可维护性
+
+### Technical Details
+- 新增文件:
+  - `src/vision-client.ts` - 视觉模型客户端统一接口
+  - `src/siliconflow-client.ts` - 硅基流动 API 客户端实现
+  - `.env.example` - 配置示例文件
+- 修改文件:
+  - `src/config.ts` - 支持多提供商配置
+  - `src/zhipu-client.ts` - 实现 VisionClient 接口
+  - `src/index.ts` - 根据配置动态选择客户端
+  - `README.md` - 完整的双模型使用文档
+
+## [1.0.3] - 2025-11-XX
+
+### Features
+- 基于智谱 GLM-4.5V 的视觉理解能力
+- 支持本地文件和远程 URL
+- 内置重试机制
+- 思考模式支持
+
+---
+
+**模型对比**:
+
+| 特性     | GLM-4.5V | DeepSeek-OCR |
+|----------|----------|--------------|
+| 费用     | 收费     | **免费**     |
+| 中文理解 | 优秀     | 良好         |
+| OCR 能力 | 良好     | **优秀**     |
+| 思考模式 | ✅        | ❌            |
+
+**推荐使用场景**:
+- 需要 OCR/文字识别 → **DeepSeek-OCR** (免费)
+- 需要深度图片理解 → **GLM-4.5V**

package/README.md

@@ -1,26 +1,28 @@
 # Luma MCP
 
-基于智谱 GLM-4.5V 的视觉理解 MCP 服务器，为不支持图片理解的 AI 助手提供视觉能力。
+多模型视觉理解 MCP 服务器，为不支持图片理解的 AI 助手提供视觉能力。
 
 [English](./docs/README_EN.md) | 中文
 
 ## 特性
 
+- **多模型支持**: 支持 GLM-4.5V（智谱）和 DeepSeek-OCR（硅基流动）
 - **简单设计**: 单一 `analyze_image` 工具处理所有图片分析任务
 - **智能理解**: 自动识别代码、UI、错误等不同场景
-- **全面支持**: 代码截图、界面设计、错误诊断、通用图片
+- **全面支持**: 代码截图、界面设计、错误诊断、OCR 文字识别
 - **标准 MCP 协议**: 无缝集成 Claude Desktop、Cline 等 MCP 客户端
-- **GLM-4.5V 驱动**: 中文理解优秀，API 性价比高
+- **免费选项**: DeepSeek-OCR 通过硅基流动提供免费调用
 - **URL 支持**: 支持本地文件和远程图片 URL
 - **重试机制**: 内置指数退避重试，提高可靠性
-- **思考模式**: 默认启用深度分析
 
 ## 快速开始
 
 ### 前置要求
 
 - Node.js >= 18.0.0
-- 智谱 AI API Key ([获取地址](https://open.bigmodel.cn/))
+- **选择一种模型**：
+  - **方案 A**: 智谱 AI API Key ([获取地址](https://open.bigmodel.cn/)) - 中文理解优秀
+  - **方案 B**: 硅基流动 API Key ([获取地址](https://cloud.siliconflow.cn/)) - **免费使用**，OCR 能力强
 
 ### 安装
 
@@ -47,7 +49,7 @@ npx luma-mcp
 
 **macOS 配置文件位置**: `~/Library/Application Support/Claude/claude_desktop_config.json`
 
-**使用 npx（推荐）**:
+**方案 A: 使用智谱 GLM-4.5V**:
 
 ```json
 {
@@ -63,7 +65,24 @@ npx luma-mcp
 }
 ```
 
-**本地开发**:
+**方案 B: 使用硅基流动 DeepSeek-OCR（免费）**:
+
+```json
+{
+  "mcpServers": {
+    "luma": {
+      "command": "npx",
+      "args": ["-y", "luma-mcp"],
+      "env": {
+        "MODEL_PROVIDER": "siliconflow",
+        "SILICONFLOW_API_KEY": "your-siliconflow-api-key"
+      }
+    }
+  }
+}
+```
+
+**本地开发（智谱）**:
 
 ```json
 {
@@ -79,13 +98,30 @@ npx luma-mcp
 }
 ```
 
+**本地开发（硅基流动）**:
+
+```json
+{
+  "mcpServers": {
+    "luma": {
+      "command": "node",
+      "args": ["D:\\codes\\Luma_mcp\\build\\index.js"],
+      "env": {
+        "MODEL_PROVIDER": "siliconflow",
+        "SILICONFLOW_API_KEY": "your-siliconflow-api-key"
+      }
+    }
+  }
+}
+```
+
 配置完成后重启 Claude Desktop。
 
 #### Cline (VSCode)
 
-**使用 npx（推荐）**:
+在项目根目录或 `.vscode/` 目录下创建 `mcp.json`
 
-在项目根目录或 `.vscode/` 目录下创建 `mcp.json`:
+**方案 A: 使用智谱 GLM-4.5V**:
 
 ```json
 {
@@ -101,16 +137,17 @@ npx luma-mcp
 }
 ```
 
-**本地开发**:
+**方案 B: 使用硅基流动 DeepSeek-OCR（免费）**:
 
 ```json
 {
   "mcpServers": {
     "luma": {
-      "command": "node",
-      "args": ["D:\\codes\\Luma_mcp\\build\\index.js"],
+      "command": "npx",
+      "args": ["-y", "luma-mcp"],
       "env": {
-        "ZHIPU_API_KEY": "your-zhipu-api-key"
+        "MODEL_PROVIDER": "siliconflow",
+        "SILICONFLOW_API_KEY": "your-siliconflow-api-key"
       }
     }
   }
@@ -119,10 +156,16 @@ npx luma-mcp
 
 #### Claude Code (命令行)
 
+**使用智谱 GLM-4.5V**:
 ```bash
 claude mcp add -s user luma-mcp --env ZHIPU_API_KEY=your-api-key -- npx -y luma-mcp
 ```
 
+**使用硅基流动 DeepSeek-OCR（免费）**:
+```bash
+claude mcp add -s user luma-mcp --env MODEL_PROVIDER=siliconflow --env SILICONFLOW_API_KEY=your-api-key -- npx -y luma-mcp
+```
+
 #### 其他工具
 
 更多 MCP 客户端配置方法请参考[智谱官方文档](https://docs.bigmodel.cn/cn/coding-plan/mcp/vision-mcp-server#claude-code)
@@ -164,6 +207,7 @@ Claude: [自动调用 analyze_image 工具]
 
 不需要 MCP 客户端即可测试：
 
+**测试智谱 GLM-4.5V**:
 ```bash
 # 设置 API Key
 export ZHIPU_API_KEY="your-api-key"  # macOS/Linux
@@ -171,7 +215,23 @@ $env:ZHIPU_API_KEY="your-api-key"    # Windows PowerShell
 
 # 测试本地图片
 npm run test:local ./test.png
+```
+
+**测试硅基流动 DeepSeek-OCR**:
+```bash
+# 设置 API Key 和提供商
+export MODEL_PROVIDER=siliconflow
+export SILICONFLOW_API_KEY="your-api-key"  # macOS/Linux
+
+$env:MODEL_PROVIDER="siliconflow"
+$env:SILICONFLOW_API_KEY="your-api-key"    # Windows PowerShell
+
+# 测试本地图片
+npm run test:local ./test.png
+```
 
+**其他测试命令**:
+```bash
 # 测试并提问
 npm run test:local ./code-error.png "这段代码有什么问题？"
 
@@ -191,41 +251,77 @@ npm run test:local https://example.com/image.jpg
   - 支持格式: JPG, PNG, WebP, GIF
   - 本地文件: 绝对路径或相对路径
   - 远程图片: https:// 开头的 URL
-- `question` (可选): 关于图片的问题或分析指令
+- `prompt` (必需): 分析指令或问题
 
 **示例**:
 
 ```typescript
 // 通用分析
 analyze_image({
-  image_source: "./screenshot.png"
+  image_source: "./screenshot.png",
+  prompt: "请详细分析这张图片的内容"
 })
 
 // 代码分析
 analyze_image({
   image_source: "./code-error.png",
-  question: "这段代码为什么报错？请提供修复建议"
+  prompt: "这段代码为什么报错？请提供修复建议"
 })
 
 // UI 分析
 analyze_image({
   image_source: "https://example.com/ui.png",
-  question: "分析这个界面的布局和可用性问题"
+  prompt: "分析这个界面的布局和可用性问题"
 })
 ```
 
 ## 环境变量
 
-| 变量名                  | 必需 | 默认值     | 说明                 |
-|-------------------------|------|------------|----------------------|
-| `ZHIPU_API_KEY`         | 是   | -          | 智谱 AI 的 API 密钥  |
-| `ZHIPU_MODEL`           | 否   | `glm-4.5v` | 使用的模型           |
-| `ZHIPU_MAX_TOKENS`      | 否   | `4096`     | 最大生成 tokens      |
-| `ZHIPU_TEMPERATURE`     | 否   | `0.7`      | 温度参数 (0-1)       |
-| `ZHIPU_TOP_P`           | 否   | `0.7`      | Top-p 参数 (0-1)     |
-| `ZHIPU_ENABLE_THINKING` | 否   | `false`    | 是否强制启用思考模式 |
-
-注意: 思考模式默认已启用，无需额外配置。
+### 通用配置
+
+| 变量名          | 必需 | 默认值      | 说明                                    |
+|------------------|------|-------------|---------------------------------------|
+| `MODEL_PROVIDER` | 否   | `zhipu`     | 模型提供商：`zhipu` 或 `siliconflow` |
+| `MODEL_NAME`     | 否   | 见下文     | 模型名称（自动根据提供商选择）       |
+| `MAX_TOKENS`     | 否   | `4096`      | 最大生成 tokens                        |
+| `TEMPERATURE`    | 否   | `0.7`       | 温度参数 (0-1)                          |
+| `TOP_P`          | 否   | `0.7`       | Top-p 参数 (0-1)                        |
+| `ENABLE_THINKING`| 否   | `false`     | 是否启用思考模式（仅 GLM-4.5V）      |
+
+### 智谱 GLM-4.5V 专用
+
+| 变量名          | 必需               | 默认值      | 说明                 |
+|------------------|---------------------|-------------|----------------------|
+| `ZHIPU_API_KEY`  | 是（使用智谱时） | -           | 智谱 AI 的 API 密钥  |
+
+默认模型：`glm-4.5v`
+
+### 硅基流动 DeepSeek-OCR 专用
+
+| 变量名                | 必需                     | 默认值                       | 说明                     |
+|------------------------|-------------------------|---------------------------------|----------------------------|
+| `SILICONFLOW_API_KEY`  | 是（使用硅基流动时） | -                               | 硅基流动的 API 密钥      |
+
+默认模型：`deepseek-ai/DeepSeek-OCR`
+
+**思考模式说明**:
+- 默认开启，提高图片分析的准确性和详细程度
+- 如需关闭（提高速度、降低成本），请在配置文件中设置：
+  ```json
+  {
+    "mcpServers": {
+      "luma": {
+        "command": "npx",
+        "args": ["-y", "luma-mcp"],
+        "env": {
+          "ZHIPU_API_KEY": "your-api-key",
+          "ZHIPU_ENABLE_THINKING": "false"
+        }
+      }
+    }
+  }
+  ```
+- 关闭后可节省 20-30% tokens 消耗，响应速度提升约 30%
 
 ## 开发
 
@@ -246,8 +342,10 @@ npm run test:local <图片路径> [问题]
 luma-mcp/
 ├── src/
 │   ├── index.ts              # MCP 服务器入口
-│   ├── config.ts             # 配置管理
+│   ├── config.ts             # 配置管理（支持多模型）
+│   ├── vision-client.ts      # 视觉模型客户端接口
 │   ├── zhipu-client.ts       # GLM-4.5V API 客户端
+│   ├── siliconflow-client.ts # DeepSeek-OCR API 客户端
 │   ├── image-processor.ts    # 图片处理
 │   ├── prompts.ts            # 提示词模板
 │   └── utils/
@@ -267,11 +365,18 @@ luma-mcp/
 
 ### 如何获取 API Key？
 
+**智谱 GLM-4.5V**:
 1. 访问 [智谱开放平台](https://open.bigmodel.cn/)
 2. 注册/登录账号
 3. 进入控制台创建 API Key
 4. 复制 API Key 到配置文件
 
+**硅基流动 DeepSeek-OCR（免费）**:
+1. 访问 [硅基流动平台](https://cloud.siliconflow.cn/)
+2. 注册/登录账号
+3. 进入 API 管理创建 API Key
+4. 复制 API Key 到配置文件
+
 ### 支持哪些图片格式？
 
 支持 JPG、PNG、WebP、GIF 格式。建议使用 JPG 格式以获得更好的压缩率。
@@ -295,15 +400,31 @@ luma-mcp/
 
 ### 成本如何？
 
-GLM-4.5V 定价请参考[智谱官方定价](https://open.bigmodel.cn/pricing)。
+**硅基流动 DeepSeek-OCR**: **完全免费**，无需付费！
 
-典型场景估算:
+**智谱 GLM-4.5V**: 定价请参考[智谱官方定价](https://open.bigmodel.cn/pricing)。
+
+典型场景估算（GLM-4.5V）:
 - 简单图片理解: 500-1000 tokens
 - 代码截图分析: 1500-2500 tokens
 - 详细 UI 分析: 2000-3000 tokens
 
 启用思考模式会增加约 20-30% tokens。
 
+### 如何选择模型？
+
+| 特性       | GLM-4.5V（智谱） | DeepSeek-OCR（硅基流动） |
+|------------|----------------|------------------------|
+| **费用**   | 收费           | **完全免费**           |
+| **中文理解** | 优秀           | 良好                   |
+| **OCR 能力** | 良好           | **优秀**               |
+| **思考模式** | 支持           | 不支持                 |
+| **适用场景** | 通用图片分析 | OCR、文字识别          |
+
+**推荐**:
+- 需要 OCR 或文字识别：选择 **DeepSeek-OCR**（免费）
+- 需要深度图片理解：选择 **GLM-4.5V**
+
 ## 贡献
 
 欢迎提交 Issue 和 Pull Request！
@@ -316,9 +437,43 @@ MIT License
 
 - [智谱 AI 开放平台](https://open.bigmodel.cn/)
 - [GLM-4.5V 文档](https://docs.bigmodel.cn/cn/guide/models/vlm/glm-4.5v)
+- [硅基流动平台](https://cloud.siliconflow.cn/)
+- [DeepSeek-OCR 文档](https://docs.siliconflow.cn/cn/api-reference/chat-completions/chat-completions)
 - [MCP 协议文档](https://modelcontextprotocol.io/)
-- [设计文档](./docs/design.md)
-- [安装配置指南](./docs/installation.md)
+
+## 更新日志
+
+### [1.1.0] - 2025-11-13
+
+#### 新增
+- 🎉 **多模型支持**: 新增硅基流动 DeepSeek-OCR 支持
+- 🆓 **免费选项**: DeepSeek-OCR 通过硅基流动提供完全免费的 OCR 服务
+- 📐 **统一接口**: 创建 VisionClient 接口，支持灵活扩展更多视觉模型
+- ⚙️ **灵活配置**: 通过 `MODEL_PROVIDER` 环境变量轻松切换模型
+
+#### 修改
+- 🔧 环境变量命名优化，支持通用配置（`MODEL_NAME`、`MAX_TOKENS` 等）
+- 📝 更新文档，提供双模型配置说明和选择建议
+- 🏭️ 重构代码结构，提升可维护性
+
+#### 技术细节
+- 新增文件:
+  - `src/vision-client.ts` - 视觉模型客户端统一接口
+  - `src/siliconflow-client.ts` - 硅基流动 API 客户端实现
+  - `.env.example` - 配置示例文件
+- 修改文件:
+  - `src/config.ts` - 支持多提供商配置
+  - `src/zhipu-client.ts` - 实现 VisionClient 接口
+  - `src/index.ts` - 根据配置动态选择客户端
+
+### [1.0.3] - 2025-11-12
+
+- 基于智谱 GLM-4.5V 的视觉理解能力
+- 支持本地文件和远程 URL
+- 内置重试机制
+- 思考模式支持
+
+更多更新历史请查看 [CHANGELOG.md](./CHANGELOG.md)
 
 ## 作者
 

package/build/config.d.ts

@@ -2,7 +2,9 @@
  * 配置管理模块
  * 从环境变量读取配置
  */
+export type ModelProvider = 'zhipu' | 'siliconflow';
 export interface LumaConfig {
+    provider: ModelProvider;
     apiKey: string;
     model: string;
     maxTokens: number;

package/build/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,UAAU,CAevC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,aAAa,CAAC;AAEpD,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,UAAU,CAiCvC"}

package/build/config.js

@@ -6,17 +6,33 @@
  * 从环境变量加载配置
  */
 export function loadConfig() {
-    const apiKey = process.env.ZHIPU_API_KEY;
-    if (!apiKey) {
-        throw new Error('ZHIPU_API_KEY environment variable is required');
+    // 确定使用的模型提供商
+    const provider = (process.env.MODEL_PROVIDER?.toLowerCase() || 'zhipu');
+    // 根据提供商获取 API Key
+    let apiKey;
+    let defaultModel;
+    if (provider === 'siliconflow') {
+        apiKey = process.env.SILICONFLOW_API_KEY;
+        defaultModel = 'deepseek-ai/DeepSeek-OCR';
+        if (!apiKey) {
+            throw new Error('SILICONFLOW_API_KEY environment variable is required when using SiliconFlow provider');
+        }
+    }
+    else {
+        apiKey = process.env.ZHIPU_API_KEY;
+        defaultModel = 'glm-4.5v';
+        if (!apiKey) {
+            throw new Error('ZHIPU_API_KEY environment variable is required when using Zhipu provider');
+        }
     }
     return {
+        provider,
         apiKey,
-        model: process.env.ZHIPU_MODEL || 'glm-4.5v',
-        maxTokens: parseInt(process.env.ZHIPU_MAX_TOKENS || '4096', 10),
-        temperature: parseFloat(process.env.ZHIPU_TEMPERATURE || '0.7'),
-        topP: parseFloat(process.env.ZHIPU_TOP_P || '0.7'),
-        enableThinking: process.env.ZHIPU_ENABLE_THINKING === 'true',
+        model: process.env.MODEL_NAME || defaultModel,
+        maxTokens: parseInt(process.env.MAX_TOKENS || '4096', 10),
+        temperature: parseFloat(process.env.TEMPERATURE || '0.7'),
+        topP: parseFloat(process.env.TOP_P || '0.7'),
+        enableThinking: process.env.ENABLE_THINKING === 'true',
     };
 }
 //# sourceMappingURL=config.js.map

package/build/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAEzC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAED,OAAO;QACL,MAAM;QACN,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,UAAU;QAC5C,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,MAAM,EAAE,EAAE,CAAC;QAC/D,WAAW,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,KAAK,CAAC;QAC/D,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,KAAK,CAAC;QAClD,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,MAAM;KAC7D,CAAC;AACJ,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,aAAa;IACb,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,WAAW,EAAE,IAAI,OAAO,CAAkB,CAAC;IAEzF,kBAAkB;IAClB,IAAI,MAA0B,CAAC;IAC/B,IAAI,YAAoB,CAAC;IAEzB,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;QAC/B,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;QACzC,YAAY,GAAG,0BAA0B,CAAC;QAE1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,sFAAsF,CAAC,CAAC;QAC1G,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;QACnC,YAAY,GAAG,UAAU,CAAC;QAE1B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;QAC9F,CAAC;IACH,CAAC;IAED,OAAO;QACL,QAAQ;QACR,MAAM;QACN,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,YAAY;QAC7C,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,MAAM,EAAE,EAAE,CAAC;QACzD,WAAW,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,KAAK,CAAC;QACzD,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,KAAK,CAAC;QAC5C,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,MAAM;KACvD,CAAC;AACJ,CAAC"}

package/build/index.js

@@ -11,6 +11,7 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { z } from 'zod';
 import { loadConfig } from './config.js';
 import { ZhipuClient } from './zhipu-client.js';
+import { SiliconFlowClient } from './siliconflow-client.js';
 import { imageToBase64, validateImageSource } from './image-processor.js';
 import { buildAnalysisPrompt } from './prompts.js';
 import { withRetry, createSuccessResponse, createErrorResponse } from './utils/helpers.js';
@@ -21,7 +22,14 @@ async function createServer() {
     logger.info('Initializing Luma MCP Server');
     // 加载配置
     const config = loadConfig();
-    const zhipuClient = new ZhipuClient(config);
+    // 根据配置选择模型客户端
+    const visionClient = config.provider === 'siliconflow'
+        ? new SiliconFlowClient(config)
+        : new ZhipuClient(config);
+    logger.info('Vision client initialized', {
+        provider: config.provider,
+        model: visionClient.getModelName()
+    });
     // 创建服务器 - 使用 McpServer
     const server = new McpServer({
         name: 'luma-mcp',
@@ -37,15 +45,18 @@ async function createServer() {
         await validateImageSource(imageSource);
         // 2. 处理图片（读取或返回URL）
         const imageDataUrl = await imageToBase64(imageSource);
-        // 3. 构建提示词（直接使用prompt）
-        const fullPrompt = buildAnalysisPrompt(prompt);
-        // 4. 调用 GLM-4.5V 分析图片
-        return await zhipuClient.analyzeImage(imageDataUrl, fullPrompt);
+        // 3. 构建提示词
+        // DeepSeek-OCR 需要简洁的 prompt，不支持复杂格式化
+        const fullPrompt = config.provider === 'siliconflow'
+            ? prompt // DeepSeek-OCR: 直接使用原始 prompt
+            : buildAnalysisPrompt(prompt); // GLM-4.5V: 使用结构化 prompt
+        // 4. 调用视觉模型分析图片
+        return await visionClient.analyzeImage(imageDataUrl, fullPrompt);
     }, 2, // 最多重试2次
     1000 // 初始延补1秒
     );
     // 注册工具 - 使用 McpServer.tool() API
-    server.tool('analyze_image', `使用智谱GLM-4.5V视觉模型分析图片内容。
+    server.tool('analyze_image', `使用视觉模型分析图片内容。支持 GLM-4.5V（智谱）和 DeepSeek-OCR（硅基流动）。
 
 **何时自动调用此工具**：
 1. 用户提供了图片文件路径（包括临时路径、相对路径、绝对路径）

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAEH,wCAAwC;AACxC,OAAO,EAAE,uBAAuB,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACpE,uBAAuB,EAAE,CAAC;AAE1B,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE3F;;GAEG;AACH,KAAK,UAAU,YAAY;IACzB,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAE5C,OAAO;IACP,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAE5B,cAAc;IACd,MAAM,YAAY,GAAiB,MAAM,CAAC,QAAQ,KAAK,aAAa;QAClE,CAAC,CAAC,IAAI,iBAAiB,CAAC,MAAM,CAAC;QAC/B,CAAC,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IAE5B,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE;QACvC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,KAAK,EAAE,YAAY,CAAC,YAAY,EAAE;KACnC,CAAC,CAAC;IAEH,uBAAuB;IACvB,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;SACV;KACF,CACF,CAAC;IAEF,aAAa;IACb,MAAM,gBAAgB,GAAG,SAAS,CAChC,KAAK,EAAE,WAAmB,EAAE,MAAc,EAAE,EAAE;QAC5C,YAAY;QACZ,MAAM,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAEvC,oBAAoB;QACpB,MAAM,YAAY,GAAG,MAAM,aAAa,CAAC,WAAW,CAAC,CAAC;QAEtD,WAAW;QACX,qCAAqC;QACrC,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,KAAK,aAAa;YAClD,CAAC,CAAC,MAAM,CAAE,8BAA8B;YACxC,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAE,yBAAyB;QAE3D,gBAAgB;QAChB,OAAO,MAAM,YAAY,CAAC,YAAY,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IACnE,CAAC,EACD,CAAC,EAAE,SAAS;IACZ,IAAI,CAAC,SAAS;KACf,CAAC;IAEF,iCAAiC;IACjC,MAAM,CAAC,IAAI,CACT,eAAe,EACf;;;;;;;;;;;;;uCAamC,EACnC;QACE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+IAA+I,CAAC;QAClL,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8HAA8H,CAAC;KAC5J,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE;gBAC7B,MAAM,EAAE,MAAM,CAAC,YAAY;gBAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;aACtB,CAAC,CAAC;YAEH,YAAY;YACZ,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YAE1E,MAAM,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;YACrD,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE;gBACpC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;YAEH,OAAO,mBAAmB,CACxB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CACzD,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,YAAY,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEhC,MAAM,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE;YAC9C,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS;AACT,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;IACxC,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IACjF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;IAC1C,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,MAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;IACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;IACzB,MAAM,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,IAAI,EAAE,CAAC"}

package/build/siliconflow-client.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 硅基流动 DeepSeek-OCR API 客户端
+ * 基于 OpenAI 兼容 API
+ */
+import type { LumaConfig } from './config.js';
+import type { VisionClient } from './vision-client.js';
+/**
+ * 硅基流动 API 客户端
+ */
+export declare class SiliconFlowClient implements VisionClient {
+    private config;
+    private apiEndpoint;
+    constructor(config: LumaConfig);
+    /**
+     * 分析图片
+     */
+    analyzeImage(imageDataUrl: string, prompt: string, enableThinking?: boolean): Promise<string>;
+    /**
+     * 获取模型名称
+     */
+    getModelName(): string;
+}
+//# sourceMappingURL=siliconflow-client.d.ts.map

package/build/siliconflow-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"siliconflow-client.d.ts","sourceRoot":"","sources":["../src/siliconflow-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AA2CvD;;GAEG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IACpD,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,WAAW,CAAoD;gBAE3D,MAAM,EAAE,UAAU;IAI9B;;OAEG;IACG,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAsEnG;;OAEG;IACH,YAAY,IAAI,MAAM;CAGvB"}