bailian-image-understanding-mcp 1.0.0

package/README.md

@@ -0,0 +1,120 @@
+# 百炼图片理解 MCP 服务器
+
+让 Claude 能"看懂"图片的 MCP 工具，基于阿里云通义千问 VL 模型。
+
+## 为什么需要这个工具
+
+Claude 本身不具备视觉能力，通过这个 MCP 服务器，你可以：
+
+- 发送图片链接或本地图片给 Claude 分析
+- 截图后直接粘贴，让 Claude 解释内容
+- 处理 base64 编码的图片数据
+
+支持的模型：
+- **qwen-vl-plus**（默认）：性价比之选
+- **qwen3-vl-plus**：第二代，性能更强
+- **qwen-vl-max**：最强能力，适合复杂场景
+
+## 安装配置
+
+### 1. 获取 API Key
+
+访问 [阿里云百炼平台](https://bailian.console.aliyun.com/)，开通大模型推理服务后创建 API Key。
+
+### 2. 安装
+
+**方式一：直接安装（推荐）**
+
+```bash
+npm install -g bailian-image-understanding-mcp
+```
+
+**方式二：从源码构建**
+
+```bash
+git clone <repo>
+cd image-understanding
+npm install && npm run build
+npm pack
+npm install -g bailian-image-understanding-mcp-*.tgz
+```
+
+### 3. 配置 Claude Desktop
+
+编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`：
+
+```json
+{
+  "mcpServers": {
+    "bailian-image": {
+      "command": "node",
+      "args": ["$(npm root -g)/bailian-image-understanding-mcp/dist/index.js"],
+      "env": {
+        "DASHSCOPE_API_KEY": "你的API密钥"
+      }
+    }
+  }
+}
+```
+
+### 4. 重启 Claude Desktop
+
+配置完成后重启，即可在对话中使用图片分析功能。
+
+## 在 Claude 中使用
+
+配置好后，直接对话即可：
+
+```
+请帮我看看这张图片是什么：https://example.com/screenshot.png
+```
+
+```
+[粘贴图片] 这张图的布局怎么实现的？
+```
+
+## 支持的图片格式
+
+- **HTTP URL**：`https://example.com/image.jpg`
+- **本地路径**：`/Users/xxx/Pictures/screenshot.png`
+- **base64**：`data:image/png;base64,iVBORw0KG...`
+
+## 环境变量
+
+| 变量 | 说明 | 默认值 |
+|-----|------|--------|
+| DASHSCOPE_API_KEY | API密钥（必需） | - |
+| QWEN_VISION_MODEL | 模型选择 | qwen-vl-plus |
+| BAILIAN_REGION | 服务区域 | cn-beijing |
+
+可用区域：`cn-beijing` | `cn-singapore` | `us-virginia`
+
+## 开发调试
+
+```bash
+# 安装依赖
+npm install
+
+# 开发模式（自动编译）
+npm run dev
+
+# 构建
+npm run build
+
+# 测试
+node test/test-api.js
+```
+
+## 相关链接
+
+- [阿里云百炼](https://bailian.console.aliyun.com/)
+- [通义千问 VL 文档](https://help.aliyun.com/zh/dashscope/developer-reference/tongyi-qianwen-vl-plus-api)
+- [MCP 协议](https://modelcontextprotocol.io/)
+
+## 致谢
+
+本项目基于 [@mcpcn/image-understanding-mcp](https://www.npmjs.com/package/@mcpcn/image-understanding-mcp) 改造
+
+## 许可证
+
+MIT

package/dist/config.d.ts

@@ -0,0 +1,3 @@
+export declare const DEFAULT_VISION_MODEL: string;
+export declare const SUPPORTED_VISION_MODELS: string[];
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,QAAkD,CAAC;AAEpF,eAAO,MAAM,uBAAuB,EAAE,MAAM,EAI3C,CAAC"}

package/dist/config.js

@@ -0,0 +1,7 @@
+export const DEFAULT_VISION_MODEL = process.env.QWEN_VISION_MODEL || 'qwen-vl-plus';
+export const SUPPORTED_VISION_MODELS = [
+    'qwen-vl-plus',
+    'qwen3-vl-plus',
+    'qwen-vl-max',
+];
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,cAAc,CAAC;AAEpF,MAAM,CAAC,MAAM,uBAAuB,GAAa;IAC/C,cAAc;IACd,eAAe;IACf,aAAa;CACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+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":""}

package/dist/index.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { ImageUnderstandingTool } from './tools/image-recognition.js';
+import { DEFAULT_VISION_MODEL, SUPPORTED_VISION_MODELS } from './config.js';
+const API_KEY = process.env.DASHSCOPE_API_KEY || process.env.BAILIAN_API_KEY;
+if (!API_KEY) {
+    console.error('错误: 未找到API密钥，请设置环境变量 DASHSCOPE_API_KEY');
+    process.exit(1);
+}
+const REGION = process.env.BAILIAN_REGION || 'cn-beijing';
+const MODEL = process.env.QWEN_VISION_MODEL || DEFAULT_VISION_MODEL;
+const imageUnderstanding = new ImageUnderstandingTool(API_KEY, REGION, MODEL);
+const server = new Server({
+    name: 'bailian-image-understanding-mcp',
+    version: '1.0.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: 'analyze_image',
+                description: `使用阿里云百炼通义千问视觉模型（${DEFAULT_VISION_MODEL}）分析图片`,
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        imageUrl: {
+                            type: 'string',
+                            description: '图片URL或base64编码',
+                        },
+                        prompt: {
+                            type: 'string',
+                            description: '分析要求',
+                            default: '请详细描述这张图片的内容',
+                        },
+                        model: {
+                            type: 'string',
+                            enum: SUPPORTED_VISION_MODELS,
+                            description: '模型版本',
+                        },
+                        temperature: {
+                            type: 'number',
+                            minimum: 0,
+                            maximum: 1,
+                            description: '温度参数（0-1）',
+                        },
+                        maxTokens: {
+                            type: 'number',
+                            minimum: 1,
+                            maximum: 8192,
+                            description: '最大输出token数',
+                        },
+                    },
+                    required: ['imageUrl'],
+                },
+            },
+        ],
+    };
+});
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case 'analyze_image': {
+                const params = (args ?? {});
+                if (!params.imageUrl) {
+                    throw new Error('imageUrl参数是必需的');
+                }
+                const result = await imageUnderstanding.analyzeImage(params);
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        }],
+                    isError: !result.success,
+                };
+            }
+            default:
+                throw new Error(`未知的工具: ${name}`);
+        }
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: false,
+                        error: error instanceof Error ? error.message : '未知错误',
+                    }, null, 2),
+                }],
+            isError: true,
+        };
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+process.on('uncaughtException', (error) => {
+    console.error(error);
+    process.exit(1);
+});
+process.on('unhandledRejection', (reason) => {
+    console.error(reason);
+    process.exit(1);
+});
+main().catch((error) => {
+    console.error('服务器启动失败:', 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":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAG5E,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;AAC7E,IAAI,CAAC,OAAO,EAAE,CAAC;IACb,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,YAAY,CAAC;AAC1D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,oBAAoB,CAAC;AAEpE,MAAM,kBAAkB,GAAG,IAAI,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAE9E,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;IACE,IAAI,EAAE,iCAAiC;IACvC,OAAO,EAAE,OAAO;CACjB,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;KACV;CACF,CACF,CAAC;AAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;IAC1D,OAAO;QACL,KAAK,EAAE;YACL;gBACE,IAAI,EAAE,eAAe;gBACrB,WAAW,EAAE,mBAAmB,oBAAoB,OAAO;gBAC3D,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,QAAQ,EAAE;4BACR,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,gBAAgB;yBAC9B;wBACD,MAAM,EAAE;4BACN,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,MAAM;4BACnB,OAAO,EAAE,cAAc;yBACxB;wBACD,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,uBAAuB;4BAC7B,WAAW,EAAE,MAAM;yBACpB;wBACD,WAAW,EAAE;4BACX,IAAI,EAAE,QAAQ;4BACd,OAAO,EAAE,CAAC;4BACV,OAAO,EAAE,CAAC;4BACV,WAAW,EAAE,WAAW;yBACzB;wBACD,SAAS,EAAE;4BACT,IAAI,EAAE,QAAQ;4BACd,OAAO,EAAE,CAAC;4BACV,OAAO,EAAE,IAAI;4BACb,WAAW,EAAE,YAAY;yBAC1B;qBACF;oBACD,QAAQ,EAAE,CAAC,UAAU,CAAC;iBACvB;aACF;SACF;KACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjD,IAAI,CAAC;QACH,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,eAAe,CAAC,CAAC,CAAC;gBACrB,MAAM,MAAM,GAAG,CAAC,IAAI,IAAI,EAAE,CAAmC,CAAC;gBAC9D,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACrB,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;gBACpC,CAAC;gBAED,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;gBAE7D,OAAO;oBACL,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;yBACtC,CAAC;oBACF,OAAO,EAAE,CAAC,MAAM,CAAC,OAAO;iBACzB,CAAC;YACJ,CAAC;YAED;gBACE,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;qBACvD,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;YACF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;IACxC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;IAC1C,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACtB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACjC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,11 @@
+import type { ImageAnalysisParams, AnalysisResult } from '../types/index.js';
+export declare class ImageUnderstandingTool {
+    private apiKey;
+    private baseUrl;
+    private defaultModel;
+    constructor(apiKey: string, region?: string, defaultModel?: string);
+    analyzeImage(params: ImageAnalysisParams): Promise<AnalysisResult>;
+    validateApiKey(): Promise<boolean>;
+    getSupportedModels(): string[];
+}
+//# sourceMappingURL=image-recognition.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"image-recognition.d.ts","sourceRoot":"","sources":["../../src/tools/image-recognition.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EAGf,MAAM,mBAAmB,CAAC;AAuC3B,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAS;gBAEjB,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAqB,EAAE,YAAY,GAAE,MAA6B;IAehG,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;IAqGlE,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAexC,kBAAkB,IAAI,MAAM,EAAE;CAG/B"}

package/dist/tools/image-recognition.js

@@ -0,0 +1,159 @@
+import axios from 'axios';
+import { z } from 'zod';
+import { readFileSync, existsSync } from 'fs';
+import { DEFAULT_VISION_MODEL, SUPPORTED_VISION_MODELS } from '../config.js';
+const ImageAnalysisParamsSchema = z.object({
+    imageUrl: z.string().min(1),
+    prompt: z.string().optional().default('请详细描述这张图片的内容'),
+    model: z.enum(SUPPORTED_VISION_MODELS).optional().default(DEFAULT_VISION_MODEL),
+    temperature: z.number().min(0).max(1).optional().default(0.7),
+    maxTokens: z.number().min(1).max(8192).optional().default(1024)
+});
+function isBase64(str) {
+    return str.startsWith('data:image/');
+}
+function isHttpUrl(str) {
+    return str.startsWith('http://') || str.startsWith('https://');
+}
+function fileToBase64(filePath) {
+    if (!existsSync(filePath)) {
+        throw new Error(`文件不存在: ${filePath}`);
+    }
+    const buffer = readFileSync(filePath);
+    const base64 = buffer.toString('base64');
+    const extToMime = {
+        '.jpg': 'image/jpeg',
+        '.jpeg': 'image/jpeg',
+        '.gif': 'image/gif',
+        '.webp': 'image/webp',
+    };
+    const ext = filePath.slice(filePath.lastIndexOf('.'));
+    const mimeType = extToMime[ext] || 'image/png';
+    return `data:${mimeType};base64,${base64}`;
+}
+export class ImageUnderstandingTool {
+    apiKey;
+    baseUrl;
+    defaultModel;
+    constructor(apiKey, region = 'cn-beijing', defaultModel = DEFAULT_VISION_MODEL) {
+        if (!apiKey)
+            throw new Error('API密钥不能为空');
+        this.apiKey = apiKey;
+        this.defaultModel = defaultModel;
+        const regionUrls = {
+            'cn-beijing': 'https://dashscope.aliyuncs.com/compatible-mode/v1',
+            'cn-singapore': 'https://dashscope-intl.aliyuncs.com/compatible-mode/v1',
+            'us-virginia': 'https://dashscope-us.aliyuncs.com/compatible-mode/v1'
+        };
+        this.baseUrl = regionUrls[region] || regionUrls['cn-beijing'];
+    }
+    async analyzeImage(params) {
+        try {
+            const validatedParams = ImageAnalysisParamsSchema.parse(params);
+            const modelToUse = validatedParams.model || this.defaultModel;
+            let finalImageUrl = validatedParams.imageUrl;
+            if (isHttpUrl(validatedParams.imageUrl)) {
+                try {
+                    await axios.head(validatedParams.imageUrl, { timeout: 10000 });
+                }
+                catch (error) {
+                    return {
+                        success: false,
+                        analysis: '',
+                        model: DEFAULT_VISION_MODEL,
+                        error: `无法访问图片URL: ${error instanceof Error ? error.message : '未知错误'}`
+                    };
+                }
+            }
+            else if (!isBase64(validatedParams.imageUrl)) {
+                try {
+                    finalImageUrl = fileToBase64(validatedParams.imageUrl);
+                }
+                catch (error) {
+                    return {
+                        success: false,
+                        analysis: '',
+                        model: DEFAULT_VISION_MODEL,
+                        error: `读取本地文件失败: ${error instanceof Error ? error.message : '未知错误'}`
+                    };
+                }
+            }
+            const requestBody = {
+                model: modelToUse,
+                messages: [{
+                        role: 'user',
+                        content: [
+                            { type: 'text', text: validatedParams.prompt },
+                            { type: 'image_url', image_url: { url: finalImageUrl } }
+                        ]
+                    }],
+                temperature: validatedParams.temperature,
+                max_tokens: validatedParams.maxTokens,
+                stream: false
+            };
+            const response = await axios.post(`${this.baseUrl}/chat/completions`, requestBody, {
+                headers: {
+                    'Authorization': `Bearer ${this.apiKey}`,
+                    'Content-Type': 'application/json'
+                },
+                timeout: 60000
+            });
+            if (!response.data?.choices?.[0]?.message?.content) {
+                throw new Error('API返回格式异常');
+            }
+            return {
+                success: true,
+                analysis: response.data.choices[0].message.content,
+                model: response.data.model,
+                tokenUsage: {
+                    promptTokens: response.data.usage.prompt_tokens,
+                    completionTokens: response.data.usage.completion_tokens,
+                    totalTokens: response.data.usage.total_tokens
+                }
+            };
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                return {
+                    success: false,
+                    analysis: '',
+                    model: DEFAULT_VISION_MODEL,
+                    error: `参数错误: ${error.errors[0].message}`
+                };
+            }
+            if (axios.isAxiosError(error)) {
+                const status = error.response?.status;
+                const msg = error.response?.data?.error?.message || error.message;
+                return {
+                    success: false,
+                    analysis: '',
+                    model: DEFAULT_VISION_MODEL,
+                    error: `API请求失败 (${status || '网络错误'}): ${msg}`
+                };
+            }
+            return {
+                success: false,
+                analysis: '',
+                model: DEFAULT_VISION_MODEL,
+                error: error instanceof Error ? error.message : '未知错误'
+            };
+        }
+    }
+    async validateApiKey() {
+        try {
+            const testImageUrl = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAABCAYAAAB+KahGAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAB3RJTUUH6gHyXAAAA0JJREFUGMVJjEAAAGGAAElFTk//8nJ7+/vQzI0fH9+nv37f//73e3d/f7+/fvH8/Pz4+/n5+/j6+vv8//z9/vz//+///wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACH5DwAAAAAAALbWA0M1AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAFlWA0hlR2A0RptOV4ptOVYptOXaptCXa4xCXZxW3atF3T4lF3LolF3TolF3XglF3n4nF3n4nF3P4vF3P4vF3f/fF3f/fF3n9/F3n9/F39//F3//Fg/////////////////////////////////f/////////////////////////3////////////////////////9///////////////////7///////////////////H//////////////////D//////////////////AP///////////////wD/////////////8B/////////////4P/////////////nw/////////////f/////////////+P/////////////3f/////////9f/5ff/wP/wf/3f4Pn4f9n3f9v3f//3f//9////////////////////f////////////////////3////////////////////9////////////////////5////////////////////ff////////////////fwD////////////8B////////////4P////////////nw';
+            const result = await this.analyzeImage({
+                imageUrl: testImageUrl,
+                prompt: '这是什么？'
+            });
+            return result.success;
+        }
+        catch {
+            return false;
+        }
+    }
+    getSupportedModels() {
+        return SUPPORTED_VISION_MODELS;
+    }
+}
+//# sourceMappingURL=image-recognition.js.map

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

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

package/dist/types/index.d.ts

@@ -0,0 +1,58 @@
+export interface BailianResponse {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        message: {
+            role: 'assistant';
+            content: string;
+        };
+        finish_reason: string;
+    }>;
+    usage: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+    request_id?: string;
+}
+export interface ImageContent {
+    type: 'text' | 'image_url';
+    text?: string;
+    image_url?: {
+        url: string;
+    };
+}
+export interface ImageMessage {
+    role: 'user';
+    content: string | ImageContent[];
+}
+export interface BailianRequest {
+    model: string;
+    messages: ImageMessage[];
+    stream?: boolean;
+    temperature?: number;
+    top_p?: number;
+    max_tokens?: number;
+}
+export interface ImageAnalysisParams {
+    imageUrl: string;
+    prompt?: string;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+}
+export interface AnalysisResult {
+    success: boolean;
+    analysis: string;
+    model: string;
+    tokenUsage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    error?: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,KAAK,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE;YACP,IAAI,EAAE,WAAW,CAAC;YAClB,OAAO,EAAE,MAAM,CAAC;SACjB,CAAC;QACF,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;IACH,KAAK,EAAE;QACL,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE;QACV,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE;QACX,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "bailian-image-understanding-mcp",
+  "version": "1.0.0",
+  "description": "阿里云百炼通义千问Qwen-VL图片内容理解MCP工具",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "bailian-image-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "clean": "rm -rf dist",
+    "pack": "npm pack"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "mcp",
+    "image-understanding",
+    "bailian",
+    "qwen",
+    "qwen-vl",
+    "aliyun",
+    "typescript"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "axios": "^1.7.9",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.9",
+    "typescript": "^5.8.2"
+  }
+}