👁️ mcp-vision-bridge
Give your text-only coding agent eyes.
接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
DeepSeek V4 Flash writes great code — but it can't see the error dialog, the broken UI, or the screenshot you just pasted. This MCP server gives any text-only agent vision by routing images through a multimodal model of your choice.
Works with Claude Code · Codex · opencode · Kimi · PI · Cursor and any MCP client.
Your agent can't see. You paste a screenshot → "I can't see images." You transcribe the error by hand. With this, the agent calls one tool and gets a complete text description — verbatim text, layout, colors, anomalies — and can debug, fix, and explain.
Not a vision model. It's a bridge: it sends your image to a multimodal model you already pay for (mimo, Claude, Gemini, GPT-4o, Qwen-VL…) and returns a detailed description. No images ever enter your agent's context.
claude plugin marketplace add KuaaMU/agent-plugins
claude plugin install mcp-vision-bridge
That's it — the plugin bundles the MCP server + vision skill + auto-loop hook. Claude Code will prompt you for your vision endpoint, API key, and model once.
Auto-updating: the MCP server self-syncs the bundled skill + hook into
~/.claude/on startup, so every restart pulls the latest version along with the npm package. SetVISION_NO_SYNC=1to disable auto-sync.
Prefer to manage it in cc-switch (see it + sync to Codex/opencode/Gemini)? Use the installer below instead.
git clone https://github.com/KuaaMU/mcp-vision-bridge && cd mcp-vision-bridge
./install.sh # auto-detects your agent
./install.sh claude | reasonix | codex | opencode | kimi if it doesn't auto-detect. You'll be asked for three values: endpoint, key, model.
Reasonix reads the same .mcp.json as Claude Code, so ./install.sh reasonix
(or a manual .mcp.json with the vision server) works — pasted images land in
.reasonix/attachments/ and image="recent" finds them.
Add this as a stdio MCP server in your agent:
{
"command": "npx",
"args": ["-y", "mcp-vision-bridge"],
"env": {
"VISION_OPENAI_BASE_URL": "https://your-endpoint/v1",
"VISION_OPENAI_API_KEY": "sk-your-key",
"VISION_MODEL": "your-vision-model"
}
}
Requires Node.js ≥ 18.
After install, restart your agent, then:
Best way — drag the image file into the chat. Dragging an image file into
any agent (TUI or GUI) inserts its real path, which analyze_image accepts
directly — works identically in Claude Code, Cowork, Codex, opencode, PI, and
more. No clipboard, no paste quirks.
analyze_image → the vision model describes it in detailPaste 3 images? The hook reads your session transcript (lossless, multi-image).
image="recent" auto-finds pasted images across Claude Code CLI, Reasonix,
Cowork, and Codex — no clipboard needed. If a desktop GUI doesn't register a
paste (it can fail silently), just drag the file in — a path always works.
Agent docs → README_AGENT.md (tool contract, source choice, error handling).
analyze_image(
image = "path | URL | clipboard | recent | session | data:URI", // single, or
["path","path",...] // several in one call
task = "describe | ocr | ui | layout | qa", // or use prompt:
prompt = "What error is on screen?",
detail = "high" | "low",
save_to = "optional file for long output"
)
image — local path, http(s) URL, "clipboard", "recent" (most recent
pasted image in this session), "session" (every image pasted in this
session, analyzed in one call), a base64 data URI, or an array of these
to analyze multiple images at once (e.g. "compare these two").task — prompt presets for common jobs; ocr asks the vision model to
extract text, ui specs a screen, etc. (There's no bundled OCR engine — the
model itself does the reading.)prompt — free-form question (overrides task). Pass the user's actual
question here — the vision model answers what you ask, so a specific question
("what error is shown?") beats a generic describe.Pasting an image into a coding agent stores it somewhere. image="recent" /
"session" find it automatically — no clipboard, no manual paths:
Windows clipboard reality: in Explorer, "copy file" (Ctrl+C) puts a file list on the clipboard — not image bytes. So pasting a local image into a CLI only works if you copy the image content (screenshot tool, browser "copy image"). Otherwise just paste the file path —
analyze_imagereads it directly.
Three parts that close the loop for a text-only agent:
analyze_image) — the capability. Sends pixels to your vision model, returns text.skills/vision/) — the guidance. Tells the agent when and how to call it.UserPromptSubmit) — the automation. Captures a pasted image from the session transcript and triggers the call for you.Install them all with the plugin (Claude Code) or install.sh (any agent).
Pure text in, pure text out. The server never interprets the image — it fetches the bytes and lets your vision model do the seeing.
All via environment variables (the MCP reads them from your agent's server config).
npm install
npm run build # tsc → dist/
npm test # vitest
npm run test:e2e # stdio pipeline against a mock provider
Layout: src/ (server), skills/vision/ (skill), hooks/ (auto-loop hook),
install.sh (installer), examples/ (per-agent templates).
Release: bump the version in package.json, push, then
git tag vX.Y.Z && git push origin vX.Y.Z — GitHub Actions runs tests and
publishes to npm automatically.
DeepSeek writes the code. mcp-vision-bridge reads the screen.
MCP server that gives text-only LLM coding agents vision — analyze images via any multimodal model (mimo, Claude, Gemini, OpenAI-compatible). Works with Claude Code, Codex, Kimi, opencode, PI.
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
MCP Vision Bridge 透過 stdio 在本機執行。
上次檢查時間:2026-11-05。 MCP server that gives text-only LLM coding agents vision — analyze images via any multimodal model (mimo, Claude, Gemini, OpenAI-compatible). Works with Claude Code, Codex, Kimi, opencode, PI.