视觉理解 MCP Server 是一个基于模型上下文协议 (Model Context Protocol) 的 Z.AI GLM-4.5V 能力实现，为 Claude Code, Cline 等兼容 MCP 的客户端提供智谱的强大能力，包括图像分析、视频理解等功能。
NPM 包地址: @z_ai/mcp-server

​
产品简介

此拥有视觉能力的 Local MCP Server 是智谱为 GLM Coding Plan PRO 及以上等级用户开发的专属 Server, 让您的 Code Agent 拥有眼睛，无限视觉理解。

​
功能特性

图像分析

支持多种图像格式的智能分析和内容理解，让您的 AI Agent 拥有视觉

视频理解

支持本地视频与远端视频的视觉理解

简单集成

一键安装，快速集成到 Claude Code 等 MCP 兼容客户端

​
支持的工具

该服务器实现了模型上下文协议，可与任何兼容 MCP 的客户端一起使用。目前提供以下工具：
  • image_analysis - 分析图像并提供详细描述，支持多种图像格式
  • video_analysis - 分析视频并提供详细描述，支持多种视频格式

​
环境变量配置

​
详细配置说明

环境变量说明默认值可选值
Z_AI_API_KEY智谱 API KEY必需配置您的API密钥
Z_AI_MODE服务平台选择ZHIPUZHIPU 或 ZAI

​
平台配置

平台地址： https://bigmodel.cn
API 基础 URL： https://open.bigmodel.cn/api/paas/v4/
获取 API Key： 智谱开放平台
Z_AI_MODE=ZHIPU
Z_AI_API_KEY=your_zhipu_api_key

​
安装与使用

​
快速开始

1

获取 API Key

前往 智谱开放平台 获取您的 API Key
2

安装 MCP 服务器

根据您使用的客户端选择相应的安装方式
3

配置环境变量

设置必要的环境变量，包括 API Key 和平台选择

​
支持的客户端

一键安装命令
claude mcp add zai-mcp-server --env Z_AI_API_KEY=your_api_key -- npx -y @z_ai/mcp-server
手动配置编辑 Claude Code 的配置文件, 位于用户目录下 .claude.json 的 MCP 部分：
{
  "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"
      }
    }
  }
}

​
使用示例

在 Claude Code 中 Z.AI MCP Sever 
claude mcp add zai-mcp-server --env Z_AI_API_KEY=your_api_key -- npx -y @z_ai/mcp-server
code

​
故障排除

​
相关资源