┌─────────────────────────────────────────────────────┐
│  文本模型 Agent（DeepSeek 等）—— 只懂文字            │
│  · 读取 Skill 的业务规则，决定何时调用什么工具        │
└──────────────────────┬──────────────────────────────┘
                       │ MCP 协议（stdio）
┌──────────────────────▼──────────────────────────────┐
│  MCP Server（本仓库，Python）—— 真实执行             │
│  · 读本地文件 / 图片 → base64 编码                    │
│  · 调用智谱 API（认证、重试、超时、异常分类）          │
│  · 提供标准化工具：vision_analyze_image / _video / _file │
└──────────────────────┬──────────────────────────────┘
                       │ HTTPS
┌──────────────────────▼──────────────────────────────┐
│  智谱 GLM-4.6V-Flash API（视觉理解，返回文本）        │
└─────────────────────────────────────────────────────┘

# 方式 A：直接 pip 安装 Release 的 wheel（最简单）
pip install "deepseek-vision-mcp @ https://github.com/JunHua-ECJTU/deepseek-vision-mcp/releases/latest/download/deepseek_vision_mcp-0.1.0-py3-none-any.whl"

# 方式 B：下载 wheel 后本地安装
pip install deepseek_vision_mcp-0.1.0-py3-none-any.whl

# 方式 C：源码包（sdist，含 skills/ 目录与测试）
pip install deepseek_vision_mcp-0.1.0.tar.gz

# Python ≥ 3.10
pip install -e ".[dev]"
# 国内网络可加镜像：-i https://pypi.tuna.tsinghua.edu.cn/simple

cp .env.example .env
# 编辑 .env，填入你的智谱 API Key（https://bigmodel.cn/usercenter/proj-mgmt/apikeys）

deepseek-vision-mcp
# 或：python -m deepseek_vision_mcp.server

{
  "mcpServers": {
    "deepseek-vision": {
      "command": "python",
      "args": ["-m", "deepseek_vision_mcp.server"],
      "env": { "ZHIPU_API_KEY": "你的Key（或从环境变量注入）" }
    }
  }
}

{
  "ok": true,
  "content": "模型的文本回答",
  "thinking": "思考内容（如开启）",
  "usage": { "prompt_tokens": 123, "completion_tokens": 45 }
}

pytest