luma-mcp 1.0.0 → 1.0.1

package/.claude/settings.local.json

@@ -0,0 +1,10 @@
+{
+  "permissions": {
+    "allow": [
+      "mcp__devmind__list_projects",
+      "mcp__time__current_time"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

package/README.md

@@ -137,9 +137,10 @@ claude mcp add -s user luma-mcp --env ZHIPU_API_KEY=your-api-key -- npx -y luma-
 - Luma MCP 主要服务于**不支持视觉的模型**（如 GPT-4、Claude Opus 等文本模型）
 
 **如何确保工具被调用**:
-1. 明确提及工具：`使用 Luma 分析这张图片`
-2. 提供图片路径：`请分析 ./screenshot.png 中的代码错误`
-3. 使用工具名称：`用 analyze_image 工具查看这张图片`
+1. 使用完整工具名：`使用 mcp__luma-mcp__analyze_image 工具分析这张图片`
+2. 使用简化名称：`用 analyze_image 工具查看 ./screenshot.png`
+3. 提供图片路径：`请用图片分析工具查看 ./screenshot.png 中的代码错误`
+4. 明确提及服务器：`通过 luma-mcp 服务器分析这张图片`
 
 **注意**: 直接在聊天框粘贴图片，非视觉模型不会自动调用 Luma，需要明确指示。
 

package/build/index.js

@@ -32,17 +32,17 @@ async function createServer() {
         },
     });
     // 创建带重试的分析函数
-    const analyzeWithRetry = withRetry(async (imageSource, question) => {
+    const analyzeWithRetry = withRetry(async (imageSource, prompt) => {
         // 1. 验证图片来源
         await validateImageSource(imageSource);
         // 2. 处理图片（读取或返回URL）
         const imageDataUrl = await imageToBase64(imageSource);
-        // 3. 构建提示词
-        const prompt = buildAnalysisPrompt(question);
+        // 3. 构建提示词（直接使用prompt）
+        const fullPrompt = buildAnalysisPrompt(prompt);
         // 4. 调用 GLM-4.5V 分析图片
-        return await zhipuClient.analyzeImage(imageDataUrl, prompt);
+        return await zhipuClient.analyzeImage(imageDataUrl, fullPrompt);
     }, 2, // 最多重试2次
-    1000 // 初始延迟1秒
+    1000 // 初始延补1秒
     );
     // 注册工具 - 使用 McpServer.tool() API
     server.tool('analyze_image', `使用智谱GLM-4.5V视觉模型分析图片内容。
@@ -59,16 +59,16 @@ async function createServer() {
 **支持来源**：本地文件、远程URL、临时文件（包括截图）。
 
 如果你是不支持视觉的AI模型，看到图片路径时应主动调用此工具来分析图片内容。`, {
-        image_source: z.string().describe('图片来源：本地文件路径（含临时路径）或远程URL。例如："./image.png"、"/tmp/screenshot.png"、"C:\\Users\\...\\image.jpg"、"https://example.com/pic.jpg"'),
-        question: z.string().optional().describe('可选：用户的问题或分析指令。例如："这段代码为什么报错？"、"分析这个UI设计的问题"、"识别图片中的文字"'),
+        image_source: z.string().describe('图片来源：本地文件路径（含临时路径）、远程URL。支持 PNG/JPG/WebP/GIF。例如："./image.png"、"/tmp/screenshot.png"、"C:\\Users\\...\\image.jpg"、"https://example.com/pic.jpg"'),
+        prompt: z.string().describe('必须：详细的分析指令。如果用户没有提供具体问题，默认使用："请详细分析这张图片的内容"。对于具体任务：代码分析、UI设计、错误诊断、文字识别等，应提供明确的指令。例如："这段代码为什么报错？"、"分析这个UI的布局和风格"、"识别图片中的所有文字"'),
     }, async (params) => {
         try {
             logger.info('Analyzing image', {
                 source: params.image_source,
-                hasQuestion: !!params.question,
+                prompt: params.prompt,
             });
             // 执行分析（带重试）
-            const result = await analyzeWithRetry(params.image_source, params.question);
+            const result = await analyzeWithRetry(params.image_source, params.prompt);
             logger.info('Image analysis completed successfully');
             return createSuccessResponse(result);
         }

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":"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"}

package/mcp-server/README.md

@@ -0,0 +1,41 @@
+# ZAI MCP Server
+
+[中文文档](https://docs.bigmodel.cn/cn/coding-plan/mcp/vision-mcp-server) | [English Document](https://docs.z.ai/devpack/mcp/vision-mcp-server)
+
+
+A Model Context Protocol (MCP) server that provides AI capabilities powered by Z.AI.
+
+## Environment Variables
+
+- `Z_AI_MODE` - The platform to use for AI services (default: `ZHIPU`)  ZHIPU or ZAI
+- `Z_AI_API_KEY` - Your API key
+ 
+For ZAI: Use ZAI platform https://z.ai/model-api
+
+For ZHIPU: Use Zhipu AI platform https://bigmodel.cn
+
+## Usage
+
+### Use this MCP Server in Claude Code
+
+It is recommended to use the version Node.js 18+, Claude Code 2.0.14+.
+
+**Note**: You need to configure `Z_AI_MODE` as `ZAI` or `ZHIPU` depending on the platform.
+
+For ZAI Use,
+
+```shell
+claude mcp add zai-mcp-server --env Z_AI_API_KEY=your_api_key Z_AI_MODE=ZAI -- npx -y "@z_ai/mcp-server"
+```
+
+For ZHIPU Use,
+
+```shell
+claude mcp add zai-mcp-server --env Z_AI_API_KEY=your_api_key Z_AI_MODE=ZHIPU -- npx -y "@z_ai/mcp-server"
+```
+
+### Use this MCP Server in Others MCP Client
+
+For Z.ai Use, refer the [Vision MCP Doc](https://docs.z.ai/devpack/mcp/vision-mcp-server)
+
+For ZhiPU Use, refer the [Vision MCP Doc](https://docs.bigmodel.cn/cn/coding-plan/mcp/vision-mcp-server)

package/mcp-server/README.zh-CN.md

@@ -0,0 +1,42 @@
+# ZAI MCP 服务器
+
+[中文文档](https://docs.bigmodel.cn/cn/coding-plan/mcp/vision-mcp-server) | [English Document](https://docs.z.ai/devpack/mcp/vision-mcp-server)
+
+一个基于 Z.AI 提供 AI 能力的模型上下文协议 (MCP) 服务器。
+
+## MCP 工具
+
+该服务器实现了模型上下文协议，可与任何兼容 MCP 的客户端一起使用。服务器提供以下工具：
+
+- `image_analysis` - 分析图像并提供详细描述
+- `video_analysis` - 分析视频并提供详细描述
+
+## 环境变量
+
+- `Z_AI_MODE` - 用于 AI 服务的平台（默认：`ZHIPU`）ZHIPU 或 ZAI
+- `Z_AI_API_KEY` - 您的 API 密钥
+
+对于 `Z_AI_MODE=ZHIPU`：使用智谱 AI 平台 https://bigmodel.cn
+
+对于 `Z_AI_MODE=ZAI`：使用 ZAI 平台 https://z.ai/model-api 
+
+
+## 安装
+
+### 从 npm 安装
+
+```bash
+npm i @z_ai/mcp-server
+```
+
+## 使用方法
+
+### 在 Claude Code 中使用此 MCP 服务器
+
+```shell
+claude mcp add zai-mcp-server --env Z_AI_API_KEY=your_api_key  -- npx -y "@z_ai/mcp-server"
+```
+
+### 在其他客户端中使用此 MCP 服务器
+
+参考文档 [视觉理解 MCP](https://docs.bigmodel.cn/cn/coding-plan/mcp/vision-mcp-server)

package/mcp-server/build/core/api-common.js

@@ -0,0 +1,122 @@
+/**
+ * Create multimodal message content
+ * @param content Content array including images, text, etc.
+ * @param prompt Text prompt
+ * @returns Formatted message array
+ */
+export function createMultiModalMessage(content, prompt) {
+    return [{
+            role: 'user',
+            content: [...content, { type: 'text', text: prompt }]
+        }];
+}
+/**
+ * Create text message
+ * @param prompt Text content
+ * @returns Formatted message array
+ */
+export function createTextMessage(prompt) {
+    return [{
+            role: 'user',
+            content: [{ type: 'text', text: prompt }]
+        }];
+}
+/**
+ * Create image message content
+ * @param imageUrl Image URL or base64 data
+ * @returns Image content object
+ */
+export function createImageContent(imageUrl) {
+    return {
+        type: 'image_url',
+        image_url: { url: imageUrl }
+    };
+}
+/**
+ * Create video message content
+ * @param videoUrl Video URL or base64 data
+ * @returns Video content object
+ */
+export function createVideoContent(videoUrl) {
+    return {
+        type: 'video_url', // Most AI models treat video as image_url type
+        video_url: { url: videoUrl }
+    };
+}
+/**
+ * Create error response
+ * @param message Error message
+ * @param error Optional error object
+ * @returns Standardized error response
+ */
+export function createErrorResponse(message, error) {
+    return {
+        success: false,
+        error: message,
+        timestamp: Date.now(),
+        ...(error && { context: { stack: error.stack, name: error.name } })
+    };
+}
+/**
+ * Create success response
+ * @param data Response data
+ * @returns Standardized success response
+ */
+export function createSuccessResponse(data) {
+    return {
+        success: true,
+        data,
+        timestamp: Date.now()
+    };
+}
+/**
+ * Format response content to MCP format
+ * @param response API response
+ * @returns MCP tool response format
+ */
+export function formatMcpResponse(response) {
+    if (response.success) {
+        const text = typeof response.data === 'string'
+            ? response.data
+            : JSON.stringify(response.data, null, 2);
+        return {
+            content: [{ type: 'text', text }]
+        };
+    }
+    else {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Error: ${response.error}`
+                }],
+            isError: true
+        };
+    }
+}
+/**
+ * Create async function with retry mechanism
+ * @param fn Async function to execute
+ * @param maxRetries Maximum retry attempts
+ * @param delay Retry delay in milliseconds
+ * @returns Wrapped function
+ */
+export function withRetry(fn, maxRetries = 3, delay = 1000) {
+    return async (...args) => {
+        let lastError;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            try {
+                return await fn(...args);
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                if (attempt === maxRetries) {
+                    throw lastError;
+                }
+                // Exponential backoff
+                const waitTime = delay * Math.pow(2, attempt);
+                await new Promise(resolve => setTimeout(resolve, waitTime));
+            }
+        }
+        throw lastError;
+    };
+}

package/mcp-server/build/core/chat-service.js

@@ -0,0 +1,80 @@
+import { ApiError } from '../types/index.js';
+import { configurationService } from './environment.js';
+import { EnvironmentService } from './environment.js';
+/**
+ * ZAI API service implementation
+ */
+export class ChatService {
+    environmentService;
+    constructor(environmentService = EnvironmentService.getInstance()) {
+        this.environmentService = environmentService;
+    }
+    /**
+     * ZAI chat completions API for vision analysis
+     */
+    async visionCompletions(messages) {
+        const visionConfig = configurationService.getVisionConfig();
+        const requestBody = {
+            model: visionConfig.model,
+            messages,
+            thinking: { type: 'enabled' },
+            stream: false,
+            temperature: visionConfig.temperature,
+            top_p: visionConfig.topP,
+            max_tokens: visionConfig.maxTokens
+        };
+        console.info('Request ZAI chat completions API for vision analysis', { model: visionConfig.model, messageCount: messages.length });
+        try {
+            const response = await this.chatCompletions(visionConfig.url, requestBody);
+            const result = response.choices?.[0]?.message?.content;
+            if (!result) {
+                throw new ApiError('Invalid API response: missing content');
+            }
+            console.info('Request chat completions API for vision analysis successful');
+            return result;
+        }
+        catch (error) {
+            console.error('Request chat completions API for vision analysis failed', { error: error instanceof Error ? error.message : String(error) });
+            throw error instanceof ApiError ? error : new ApiError(`API call failed: ${error}`);
+        }
+    }
+    /**
+     * Make HTTP request to ZAI API with proper headers and error handling
+     */
+    async chatCompletions(url, body) {
+        const apiConfig = configurationService.getVisionConfig();
+        const apiKey = this.environmentService.getApiKey();
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), apiConfig.timeout);
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Authorization': `Bearer ${apiKey}`,
+                    'Content-Type': 'application/json',
+                    'X-Title': '4.5V MCP Local',
+                    'Accept-Language': 'en-US,en'
+                },
+                body: JSON.stringify(body),
+                signal: controller.signal
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new ApiError(`HTTP ${response.status}: ${errorText}`);
+            }
+            return await response.json();
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof ApiError) {
+                throw error;
+            }
+            throw new ApiError(`Network error: ${error}`);
+        }
+    }
+}
+/**
+ * ZAI API chat completions service instance
+ */
+export const chatService = new ChatService();

package/mcp-server/build/core/environment.js

@@ -0,0 +1,128 @@
+import { ApiError } from '../types/index.js';
+/**
+ * Environment configuration service using singleton pattern
+ */
+export class EnvironmentService {
+    static instance;
+    config = null;
+    constructor() { }
+    /**
+     * Get singleton instance of EnvironmentService
+     */
+    static getInstance() {
+        if (!EnvironmentService.instance) {
+            EnvironmentService.instance = new EnvironmentService();
+        }
+        return EnvironmentService.instance;
+    }
+    /**
+     * Get environment configuration
+     */
+    getConfig() {
+        if (!this.config) {
+            this.config = this.loadEnvironmentConfig();
+        }
+        return this.config;
+    }
+    /**
+     * Load environment configuration from process.env
+     */
+    loadEnvironmentConfig() {
+        const envConfig = { ...process.env };
+        if (!envConfig.Z_AI_BASE_URL) {
+            // for z.ai paas is https://api.z.ai/api/paas/v4/
+            // for zhipuai is https://open.bigmodel.cn/api/paas/v4/
+            envConfig.Z_AI_BASE_URL = 'https://open.bigmodel.cn/api/paas/v4/';
+        }
+        if (envConfig.PLATFORM_MODE != null) {
+            console.info('Running in mode', { mode: envConfig.PLATFORM_MODE });
+            if (envConfig.PLATFORM_MODE === 'Z_AI' || envConfig.PLATFORM_MODE === 'ZAI' || envConfig.PLATFORM_MODE === 'Z') {
+                envConfig.Z_AI_BASE_URL = 'https://api.z.ai/api/paas/v4/';
+                envConfig.PLATFORM_MODE = 'ZAI';
+            }
+            else if (envConfig.PLATFORM_MODE === 'ZHIPU_AI' || envConfig.PLATFORM_MODE === 'ZHIPUAI'
+                || envConfig.PLATFORM_MODE === 'ZHIPU' || envConfig.PLATFORM_MODE === 'BIGMODEL') {
+                envConfig.Z_AI_BASE_URL = 'https://open.bigmodel.cn/api/paas/v4/';
+                envConfig.PLATFORM_MODE = 'ZHIPU';
+            }
+        }
+        else {
+            envConfig.PLATFORM_MODE = 'ZHIPU';
+        }
+        if (!envConfig.Z_AI_API_KEY && envConfig.ZAI_API_KEY) {
+            envConfig.Z_AI_API_KEY = envConfig.ZAI_API_KEY;
+            console.warn("[important] Z_AI_API_KEY is not set but found ZAI_API_KEY, using ZAI_API_KEY as Z_AI_API_KEY");
+        }
+        // for some user forget replace the `your_api_key` `your_zhipu_api_key` `your_zai_api_key` in the env
+        if (!envConfig.Z_AI_API_KEY || envConfig.Z_AI_API_KEY?.toLowerCase().includes('api')
+            || envConfig.Z_AI_API_KEY?.toLowerCase().includes('key')) {
+            if (envConfig.ANTHROPIC_AUTH_TOKEN && !envConfig.ANTHROPIC_AUTH_TOKEN?.toLowerCase().includes('api')) {
+                // use the ANTHROPIC_AUTH_TOKEN as Z_AI_API_KEY if available
+                envConfig.Z_AI_API_KEY = envConfig.ANTHROPIC_AUTH_TOKEN;
+                console.warn('[important] Z_AI_API_KEY is not set but found ANTHROPIC_AUTH_TOKEN, using ANTHROPIC_AUTH_TOKEN as Z_AI_API_KEY');
+            }
+            else {
+                throw new ApiError('Z_AI_API_KEY environment variable is required, please set your actual API key');
+            }
+        }
+        return {
+            Z_AI_BASE_URL: envConfig.Z_AI_BASE_URL,
+            Z_AI_API_KEY: envConfig.Z_AI_API_KEY,
+            Z_AI_VISION_MODEL: envConfig.Z_AI_VISION_MODEL,
+            Z_AI_VISION_MODEL_TEMPERATURE: envConfig.Z_AI_VISION_MODEL_TEMPERATURE,
+            Z_AI_VISION_MODEL_TOP_P: envConfig.Z_AI_VISION_MODEL_TOP_P,
+            Z_AI_VISION_MODEL_MAX_TOKENS: envConfig.Z_AI_VISION_MODEL_MAX_TOKENS,
+            Z_AI_TIMEOUT: envConfig.Z_AI_TIMEOUT,
+            Z_AI_RETRY_COUNT: envConfig.Z_AI_RETRY_COUNT,
+            SERVER_NAME: envConfig.SERVER_NAME,
+            SERVER_VERSION: envConfig.SERVER_VERSION,
+            PLATFORM_MODE: envConfig.PLATFORM_MODE
+        };
+    }
+    /**
+     * Get server configuration
+     */
+    getServerConfig() {
+        const config = this.getConfig();
+        return {
+            name: config.SERVER_NAME || 'zai-mcp-server',
+            version: config.SERVER_VERSION || '0.1.0'
+        };
+    }
+    /**
+     * Get platform mode
+     */
+    getPlatformModel() {
+        const config = this.getConfig();
+        return config.PLATFORM_MODE || 'ZHIPU';
+    }
+    /**
+     * Get API configuration
+     */
+    getVisionConfig() {
+        const config = this.getConfig();
+        return {
+            model: config.Z_AI_VISION_MODEL || 'glm-4.5v',
+            timeout: parseInt(config.Z_AI_TIMEOUT || '300000'),
+            retryCount: parseInt(config.Z_AI_RETRY_COUNT || '1'),
+            url: config.Z_AI_BASE_URL + 'chat/completions',
+            temperature: parseFloat(config.Z_AI_VISION_MODEL_TEMPERATURE || '0.8'),
+            topP: parseFloat(config.Z_AI_VISION_MODEL_TOP_P || '0.6'),
+            maxTokens: parseInt(config.Z_AI_VISION_MODEL_MAX_TOKENS || '16384')
+        };
+    }
+    /**
+     * Get ZAI API key from configuration
+     */
+    getApiKey() {
+        return this.getConfig().Z_AI_API_KEY;
+    }
+}
+/**
+ * Global environment service instance
+ */
+export const environmentService = EnvironmentService.getInstance();
+/**
+ * Configuration service instance (for backward compatibility)
+ */
+export const configurationService = environmentService;