目录功能特性图像分析视频理解简单集成支持的工具环境变量配置安装与使用使用示例视觉理解 MCP Server 是智谱为 GLM Coding Plan 用户开发的专属 Local MCP Server基于模型上下文协议Model Context Protocol可为 Claude Code、Cline 等兼容 MCP 的客户端提供图像分析、视频理解等视觉能力。如需体验 GLM-5.3-Flash 能力请安装最新版本( 0.1.2) 的视觉理解MCP服务器。老用户可能会使用旧缓存版本需删除 npx 缓存或将z_ai/mcp-server加上latest标签强制安装最新版本即z_ai/mcp-serverlatest。功能特性图像分析支持多种图像格式的智能分析和内容理解让您的 AI Agent 拥有视觉视频理解支持本地视频与远端视频的视觉理解简单集成一键安装快速集成到 Claude Code 等 MCP 兼容客户端支持的工具该服务器实现了模型上下文协议可与任何兼容 MCP 的客户端一起使用模型可根据用户 Prompt 自主调用最匹配的工具实现在以下类型任务中更精准的效果。目前提供以下工具ui_to_artifact- 将 UI 截图转换为代码、提示词、设计规范或自然语言描述覆盖从前端落地到生成式设计提示的全流程extract_text_from_screenshot- 使用先进的 OCR 能力从截图中提取和识别文字。专门用于代码、终端输出、文档和通用文本的提取diagnose_error_screenshot- 解析错误弹窗、堆栈和日志截图给出定位与修复建议understand_technical_diagram- 针对架构图、流程图、UML、ER 图等技术图纸生成结构化解读analyze_data_visualization- 阅读仪表盘、统计图表提炼趋势、异常与业务要点ui_diff_check- 对比两张 UI 截图识别视觉差异和实现偏差。专门用于 UI 质量保证和设计到实现的验证image_analysis- 通用图像理解能力适配未被专项工具覆盖的视觉内容video_analysis- 支持 MP4/MOV/M4V(限制本地最大8M) 等格式的视频场景解析抓取关键帧、事件与要点环境变量配置详细配置说明环境变量说明默认值可选值Z_AI_API_KEY智谱 API KEY必需配置您的API密钥Z_AI_MODE服务平台选择ZHIPUZHIPU或ZAI安装与使用快速开始获取 API Key个人版套餐或领取体验卡的用户通过 个人编程套餐 套餐概览新建 API Key团队版套餐的成员通过 团队编程套餐 我的套餐新建 API Key安装 MCP 服务器前提条件您需要安装 Node.js 18 或更新版本根据您使用的客户端参考下方选择相应的安装方式支持的客户端Claude CodeCline (VS Code)OpenCodeCrushRoo Code, Kilo Code 等其它在 Claude Code 中使用 GLM Coding Plan 时模型服务端已内置image_analysis工具具备图片理解能力无需安装。如需使用全部视觉工具再按以下方式安装。方式一一键安装命令注意替换里面的YOUR_API_KEY为您上一步获取到的 API Keyclaude mcp add -s user zai-mcp-server --env Z_AI_API_KEYYOUR_API_KEY -- npx -y z_ai/mcp-server若您忘记替换 API Key重新执行安装命令前需要先卸载旧的此 MCP Serverclaude mcp list claude mcp remove zai-mcp-server若您在 Windows 系统的 PowerShell 中执行上述命令时遇到 -y 参数问题请尝试使用 Windows 命令提示符 (CMD) 执行相同的命令。 若遇到告警 Windows requires ‘cmd /c’ wrapper to execute npx可以忽略。方式二手动配置编辑 Claude Code 的配置文件, 位于用户目录下.claude.json的 MCP 部分注意替换里面的YOUR_API_KEY为您上一步获取到的 API Key{ mcpServers: { zai-mcp-server: { type: stdio, command: npx, args: [ -y, z_ai/mcp-server ], env: { Z_AI_API_KEY: YOUR_API_KEY, Z_AI_MODE: ZHIPU } } } }使用示例通过上一步将视觉 MCP 服务器安装到客户端后您就可以在自己的 Coding 客户端通过对话的方式直接使用MCP了。比如下面在 Claude Code 中对话输入hi describe this xx.pngMCP Server 会处理图片并返回描述结果。(前置条件是您的当前目录下有该图片)除了 Claude Code 之外直接在客户端粘贴图片无法调用此 MCP Server客户端默认会将图片转码后直接调用模型接口。最佳实践是将图片放到本地目录通过对话的方式指定图片名称或路径来调用 Mcp Server。例如:What does demo.png describe?故障排除在本地命令行直接执行下面的命令验证其是否能安装到本地用于排查是否是环境权限等问题Linux/macOSWindows CmdWindows PowerShellZ_AI_API_KEYYOUR_API_KEY npx -y z_ai/mcp-server若安装成功则表示环境正确问题可能在客户端配置上请检查客户端的 MCP 配置。若安装失败请根据错误信息进行排查建议将错误信息粘贴给大模型进行分析解决。其它常见问题连接失败API Key 无效连接超时​相关资源模型上下文协议 (MCP) 官方文档Claude Code MCP 配置指南MCP 使用额度说明视觉模型介绍