mcp-ktt-ocr 1.0.0

package/README.md

@@ -0,0 +1,115 @@
+# MCP Order OCR Service
+
+基于阿里云百炼 qwen-vl 模型的订单截图 OCR 识别 MCP 服务。
+
+## 功能特性
+
+- **订单截图识别** (`recognize_order_screenshot`)：识别订单截图，提取订单号、商品信息、物流信息等结构化数据
+- **通用 OCR** (`general_ocr`)：通用图片文字识别，提取图片中的所有文字内容
+- **图片内容分析** (`analyze_image_content`)：分析图片内容，判断图片类型并提取关键信息
+
+## 安装
+
+```bash
+npm install mcp-order-ocr
+```
+
+## 配置
+
+### 环境变量
+
+在使用前需要设置阿里云 DashScope API Key：
+
+```bash
+export DASHSCOPE_API_KEY=your_api_key_here
+```
+
+### 在百炼平台配置 MCP 服务
+
+1. 登录百炼控制台：https://bailian.console.aliyun.com/
+2. 进入「插件」->「MCP 服务」
+3. 点击「新增自定义 MCP」
+4. 填写 npm 包名：`mcp-order-ocr`
+5. 配置环境变量：`DASHSCOPE_API_KEY`
+6. 保存并在智能体应用中启用
+
+## 工具说明
+
+### 1. recognize_order_screenshot
+
+识别订单截图，返回结构化的订单信息。
+
+**参数：**
+- `image_url` (string, 必填)：订单截图的 URL 地址
+
+**返回示例：**
+```json
+{
+  "order_id": "250704-308244682452790",
+  "group_name": "团团优选",
+  "product_name": "【厚底小金豆双带勃肯凉拖鞋】",
+  "product_spec": "金豆粉色,36-37",
+  "quantity": "1",
+  "price": "29.9",
+  "order_status": "已发货",
+  "logistics_company": "邮政快递",
+  "tracking_number": "9879437921211",
+  "create_time": "2025-07-04 15:30",
+  "buyer_remark": null
+}
+```
+
+### 2. general_ocr
+
+通用图片文字识别。
+
+**参数：**
+- `image_url` (string, 必填)：图片的 URL 地址
+- `custom_prompt` (string, 可选)：自定义提示词
+
+### 3. analyze_image_content
+
+分析图片内容和类型。
+
+**参数：**
+- `image_url` (string, 必填)：图片的 URL 地址
+
+**返回示例：**
+```json
+{
+  "image_type": "订单截图",
+  "key_info": {
+    "order_id": "250704-308244682452790",
+    "product": "凉拖鞋"
+  },
+  "suggested_action": "可以查询该订单的物流信息"
+}
+```
+
+## 本地开发
+
+```bash
+# 克隆项目
+git clone <repo_url>
+cd mcp-ocr-service
+
+# 安装依赖
+npm install
+
+# 编译
+npm run build
+
+# 运行（需要设置 DASHSCOPE_API_KEY）
+npm start
+```
+
+## 技术栈
+
+- TypeScript
+- @modelcontextprotocol/sdk
+- 阿里云 DashScope qwen-vl-max 模型
+
+## License
+
+MIT
+

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * MCP Order OCR Service
+ *
+ * 提供订单截图 OCR 识别功能的 MCP 服务
+ * 使用阿里云百炼 qwen-vl 模型进行图片理解
+ */
+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;;;;;GAKG"}

package/dist/index.js

@@ -0,0 +1,237 @@
+#!/usr/bin/env node
+/**
+ * MCP Order OCR Service
+ *
+ * 提供订单截图 OCR 识别功能的 MCP 服务
+ * 使用阿里云百炼 qwen-vl 模型进行图片理解
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+// 环境变量配置
+const DASHSCOPE_API_KEY = process.env.DASHSCOPE_API_KEY || "";
+const DASHSCOPE_BASE_URL = "https://dashscope.aliyuncs.com/compatible-mode/v1";
+// 创建 MCP 服务器
+const server = new McpServer({
+    name: "mcp-ktt-ocr",
+    version: "1.0.0",
+});
+/**
+ * 调用阿里云百炼 qwen-vl 模型进行图片理解
+ */
+async function analyzeImage(imageUrl, prompt) {
+    if (!DASHSCOPE_API_KEY) {
+        throw new Error("DASHSCOPE_API_KEY environment variable is not set");
+    }
+    const requestBody = {
+        model: "qwen-vl-max",
+        messages: [
+            {
+                role: "user",
+                content: [
+                    {
+                        type: "image_url",
+                        image_url: {
+                            url: imageUrl,
+                        },
+                    },
+                    {
+                        type: "text",
+                        text: prompt,
+                    },
+                ],
+            },
+        ],
+        max_tokens: 2000,
+    };
+    const response = await fetch(`${DASHSCOPE_BASE_URL}/chat/completions`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${DASHSCOPE_API_KEY}`,
+        },
+        body: JSON.stringify(requestBody),
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`API request failed: ${response.status} - ${errorText}`);
+    }
+    const data = (await response.json());
+    const content = data.choices?.[0]?.message?.content;
+    if (!content) {
+        throw new Error("No content in API response");
+    }
+    return content;
+}
+/**
+ * 解析订单信息的结构化 prompt
+ */
+const ORDER_OCR_PROMPT = `请仔细分析这张订单截图，提取以下信息并以JSON格式返回：
+
+{
+  "order_id": "订单编号（格式如：250704-308244682452790 或 PO-开头的编号）",
+  "group_name": "团长名称或店铺名称（如果可见）",
+  "product_name": "商品名称",
+  "product_spec": "商品规格（如：颜色、尺码等）",
+  "quantity": "数量",
+  "price": "价格",
+  "order_status": "订单状态（如：待发货、已发货、已完成等）",
+  "logistics_company": "快递公司（如果可见）",
+  "tracking_number": "快递单号（如果可见）",
+  "create_time": "下单时间（如果可见）",
+  "buyer_remark": "买家备注（如果可见）"
+}
+
+注意事项：
+1. 如果某个字段在图片中不可见或无法识别，请设置为 null
+2. 订单编号是最重要的信息，请务必准确识别
+3. 如果图片模糊或信息不完整，请在返回的 JSON 中添加 "confidence" 字段说明可信度
+4. 如果图片不是订单截图，请返回 {"error": "这不是一张订单截图"}`;
+/**
+ * 通用图片 OCR prompt
+ */
+const GENERAL_OCR_PROMPT = `请识别这张图片中的所有文字内容，并按照从上到下、从左到右的顺序返回文字。
+
+如果图片中有表格，请尽量保持表格结构。
+如果图片中有重要的数字（如订单号、金额、电话等），请特别标注。`;
+// 注册工具
+// 工具1：订单截图识别
+server.tool("recognize_order_screenshot", "识别订单截图，提取订单号、商品信息、物流信息等结构化数据", {
+    image_url: z.string().describe("订单截图的 URL 地址（支持 http/https 链接或 base64 编码）"),
+}, async ({ image_url }) => {
+    try {
+        const result = await analyzeImage(image_url, ORDER_OCR_PROMPT);
+        // 尝试解析 JSON 结果
+        let parsedResult;
+        try {
+            // 提取 JSON 部分（模型可能会在 JSON 前后添加说明文字）
+            const jsonMatch = result.match(/\{[\s\S]*\}/);
+            if (jsonMatch) {
+                parsedResult = JSON.parse(jsonMatch[0]);
+            }
+            else {
+                parsedResult = { raw_text: result };
+            }
+        }
+        catch {
+            parsedResult = { raw_text: result };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(parsedResult, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Unknown error";
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ error: errorMessage }),
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// 工具2：通用 OCR 识别
+server.tool("general_ocr", "通用图片文字识别，提取图片中的所有文字内容", {
+    image_url: z.string().describe("图片的 URL 地址（支持 http/https 链接或 base64 编码）"),
+    custom_prompt: z.string().optional().describe("自定义提示词（可选，用于指定识别重点）"),
+}, async ({ image_url, custom_prompt }) => {
+    try {
+        const prompt = custom_prompt || GENERAL_OCR_PROMPT;
+        const result = await analyzeImage(image_url, prompt);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: result,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Unknown error";
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ error: errorMessage }),
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// 工具3：图片内容分析
+server.tool("analyze_image_content", "分析图片内容，判断图片类型并提取关键信息", {
+    image_url: z.string().describe("图片的 URL 地址"),
+}, async ({ image_url }) => {
+    try {
+        const prompt = `请分析这张图片：
+
+1. 图片类型：判断这是什么类型的图片（订单截图、商品图片、物流截图、聊天截图、其他）
+2. 关键信息：提取图片中的关键信息
+3. 建议操作：基于图片内容，建议下一步应该做什么
+
+请以JSON格式返回：
+{
+  "image_type": "图片类型",
+  "key_info": {
+    // 根据图片类型返回相应的关键信息
+  },
+  "suggested_action": "建议操作"
+}`;
+        const result = await analyzeImage(image_url, prompt);
+        // 尝试解析 JSON
+        let parsedResult;
+        try {
+            const jsonMatch = result.match(/\{[\s\S]*\}/);
+            if (jsonMatch) {
+                parsedResult = JSON.parse(jsonMatch[0]);
+            }
+            else {
+                parsedResult = { raw_text: result };
+            }
+        }
+        catch {
+            parsedResult = { raw_text: result };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(parsedResult, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Unknown error";
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ error: errorMessage }),
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// 启动服务器
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("MCP KTT OCR Service started");
+}
+main().catch((error) => {
+    console.error("Failed to start server:", 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/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "mcp-ktt-ocr",
+  "version": "1.0.0",
+  "description": "MCP service for order screenshot OCR recognition using Alibaba Cloud Bailian qwen-vl model",
+  "main": "dist/index.js",
+  "bin": {
+    "mcp-ktt-ocr": "dist/index.js"
+  },
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc -w",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "ocr",
+    "order-recognition",
+    "alibaba-cloud",
+    "bailian",
+    "qwen-vl"
+  ],
+  "author": "AICustomerService",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^25.0.6",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "zod": "^4.3.5"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist/**/*"
+  ]
+}