EDMOK/claude-vision-mcp
MCP server empowering text-only LLMs with image analysis via any OpenAI-compatible vision API
安装Install
dsh plugin --profile web add github:EDMOK/claude-vision-mcp把 EDMOK/claude-vision-mcp 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
Claude Vision MCP
让纯文本 LLM 通过 MCP 协议调用视觉 API 分析图片
最快捷的方式：让 AI 帮你装
把 https://github.com/EDMOK/claude-vision-mcp.git 发给你的 AI 工具，告诉它安装这个 Vision MCP。
AI 可以直接按照下面「Claude Code 安装」一节的步骤自动完成安装。
手动安装
git clone https://github.com/EDMOK/claude-vision-mcp.git
cd claude-vision-mcp
预编译产物在 dist/index.js（单文件 ~721KB，已打包所有依赖），无需 npm install，Node.js >= 20 即可运行。
Claude Code 安装
推荐安放位置
将 MCP Server 复制到本机稳定目录，避免依赖 U 盘、临时目录或源码工作目录：
C:\Users\<User>\.claude\mcp-servers\vision-mcp-server
需要复制完整目录，至少包含：
dist/
package.json
node_modules/
注册 MCP Server
使用 claude mcp add 注册：
claude mcp add \
--scope local \
--transport stdio \
--env VISION_API_KEY="sk-..." \
--env VISION_BASE_URL="https://api.openai.com/v1" \
--env VISION_MODEL="gpt-4o" \
vision \
-- node "C:\Users\<User>\.claude\mcp-servers\vision-mcp-server\dist\index.js"
注意：
--scope、--transport、--env必须放在 MCP Server 名称vision之前。--后面是实际启动 MCP Server 的命令和参数。- 包含 API Key 的配置应使用
local或userscope，避免使用projectscope 导致密钥进入版本控制。
验证
claude mcp get vision
claude mcp list
期望看到 Status: ✓ Connected。
注册完成后需要重启 Claude Code 会话，新的 MCP 工具才会生效。
其他 MCP 客户端配置
在 MCP 配置文件的 mcpServers 中添加，将路径替换为你的实际目录。
macOS / Linux
~/.claude.json：
"vision": {
"command": "/path/to/claude-vision-mcp/dist/index.js",
"env": {
"VISION_API_KEY": "sk-...",
"VISION_MODEL": "gpt-4o"
},
"type": "stdio"
}
Windows
%USERPROFILE%\.claude.json：
"vision": {
"command": "node",
"args": ["C:\\path\\to\\claude-vision-mcp\\dist\\index.js"],
"env": {
"VISION_API_KEY": "sk-...",
"VISION_BASE_URL": "https://openai.com/v1",
"VISION_MODEL": "Qwen/Qwen3.5-27B"
},
"type": "stdio"
}
配置完成后重启 MCP 客户端即可调用 vision_analyze 工具。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
image_type |
string | ✅ | url / file / clipboard / base64 / multi |
image_data |
string | ❌ | URL、本地路径或 Base64 字符串 |
media_type |
string | ❌ | Base64 时需要，如 image/png |
images |
array | ❌ | multi 模式时传多张图片 |
prompt |
string | ❌ | 自定义分析提示词 |
max_tokens |
number | ❌ | 最大输出 token 数（默认 2048） |
环境变量
| 变量 | 必填 | 默认值 | 说明 |
|---|---|---|---|
VISION_API_KEY |
✅ | — | OpenAI 兼容 API 密钥 |
VISION_BASE_URL |
❌ | https://api.openai.com/v1 |
API 地址 |
VISION_MODEL |
❌ | gpt-4o |
视觉模型 |
VISION_TOOL_DISABLED |
❌ | false |
设为 true 隐藏工具 |
系统要求
- Node.js >= 20
- 剪贴板功能仅 Windows + PowerShell
更新日志
v1.1.0
- 工具 description 全面重写 — 6 部分结构化指引（功能说明、必要性、使用场景、5 种 image_type 决策树、prompt 用法、输出说明），让纯文本模型更精准地调用视觉能力
- 剪贴板能力明确告知模型 — 模型现在知道
clipboard模式可直接读取 Windows 系统剪贴板，不再要求用户手动粘贴图片 - 构建输出改为 CommonJS — 修复 OpenAI SDK 在 ESM 下动态
require的兼容问题 - 参数 description 精简优化 — 每个参数配场景化指引，降低模型误用率
License
MIT
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
nexu-io/open-design
🎨 Best DeepSeek Harness Design Plugin. The open-source Claude Design alternative. 🖥️ Local-first desktop app. 🖼️ Your…
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…
-
titanwings/colleague-skill
将冰冷的离别化为温暖的 Skill，欢迎加入数字生命1.0！Transforming cold farewells into warm skills? It's giving rebirth era. Welcome to Digital …