{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_kgsz9jamnsb2","handle":"claude-vision-mcp","url":"https://wellknown.network/agents/claude-vision-mcp","links":{"self":"https://wellknown.network/agents/claude-vision-mcp/record.json","html":"https://wellknown.network/agents/claude-vision-mcp","markdown":"https://wellknown.network/agents/claude-vision-mcp/record.md","api":"https://wellknown.network/api/v1/agents/claude-vision-mcp","status":"https://wellknown.network/api/v1/agents/claude-vision-mcp/status","claim":"https://wellknown.network/agents/claude-vision-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/claude-vision-mcp/claim.json","badge":"https://wellknown.network/agents/claude-vision-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:claude-vision-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"claude-vision-mcp","summary":"基于 Claude API 的视觉识别 MCP server:为不支持视觉的主模型多一双眼睛。内部 http 直调视觉网关,图片放 user message 顶层 image content block,tool_result 仅返回文字描述,绕开 tool_result 内嵌 image 的网关兼容缺陷。","description":"# claude-vision-mcp\n\n> 基于 Claude API 的视觉识别 MCP server:为不支持视觉识别的主模型多一双眼睛。\n\n[![PyPI](https://img.shields.io/pypi/v/claude-vision-mcp.svg)](https://pypi.org/project/claude-vision-mcp/)\n\n## 这是什么\n\n一个 stdio MCP server,暴露 `describe_image` 工具。主代理(如 Claude Code)调用它传入本地图片路径,工具内部用 http 直调视觉网关的 `/v1/messages`,**把图片放在 user message 顶层 image content block**(绕开网关只解析顶层 image、不解析 `tool_result` 内嵌 image 的兼容缺陷),视觉模型返回的文字作为 `tool_result` 返回给主代理。\n\n**为什么需要它**:Claude Code 的 `Read` 工具读图时,会把图片塞进 `tool_result.content` 内嵌的 image block。但部分网关(如本环境的 `xopkimik26`)只解析 user message **顶层** image、不解析 `tool_result` 内嵌 image——结果主模型「看不到图」。本工具把识图挪到一个独立的 MCP server 里,**对主代理消息流可见的永远是纯文字 tool_result**,图片在工具内部的 http 调用中消化,从源头绕开缺陷。\n\n详细背景见 [cnpc/claude #48](https://cnb.cool/cnpc/claude/-/issues/48)。\n\n## 安装\n\n### 方式一:`uvx`(推荐,Claude Code 集成)\n\n无需 clone,直接在 Claude Code 配置里挂载:\n\n```jsonc\n// ~/.claude.json 或项目 .claude.json\n{\n  \"mcpServers\": {\n    \"claude-vision-mcp\": {\n      \"command\": \"uvx\",\n      \"args\": [\"claude-vision-mcp\"],\n      \"env\": {\n        \"ANTHROPIC_BASE_URL\": \"${ANTHROPIC_BASE_URL}\",\n        \"ANTHROPIC_AUTH_TOKEN\": \"${ANTHROPIC_AUTH_TOKEN}\",\n        \"VISION_MODEL\": \"${VISION_MODEL}\"\n      },\n      \"timeout\": 120000\n    }\n  }\n}\n```\n\n`uvx` 会自动从 PyPI 拉起最新版本,隔离虚拟环境,不污染系统 Python。\n\n### 方式二:本地开发\n\n```bash\ngit clone https://cnb.cool/cnpc/mcp/claude-vision-mcp.git\ncd claude-vision-mcp\nuv sync --extra dev           # 装依赖 + dev 依赖\nuv run pytest                 # 跑测试\nuv run python -m claude_vision_mcp.server   # 直接启动 stdio server\n```\n\n## 环境变量\n\n### 网关配置(必填)\n\n| 变量 | 必填 | 说明 |\n| --- | --- | --- |\n| `ANTHROPIC_BASE_URL` | 是 | 视觉网关基地址(如 `https://api.cnb.cool/...`),不带尾部斜杠 |\n| `ANTHROPIC_AUTH_TOKEN` | 是 | 网关认证令牌,同时用作 `x-api-key` 与 `Authorization: Bearer` |\n| `VISION_MODEL` | 是 | 支持视觉的多模态模型 ID(如 `xopkimik26`),由调用方注入不写死 |\n\n### 超时/重试配置(选填,未设时用默认值)\n\n网关调用**默认走流式**(SSE),对瞬态错误(超时、连接失败、429 限流、5xx、524)做有限重试,指数退避。以下变量可覆盖默认值,在 `.claude.json` 的 `env` 字段透传:\n\n| 变量 | 默认值 | 说明 |\n| --- | --- | --- |\n| `VISION_CONNECT_TIMEOUT` | `10` | TCP …","publisher":null,"homepage":"https://cnb.cool/cnpc/mcp/claude-vision-mcp","repository":"https://cnb.cool/cnpc/mcp/claude-vision-mcp","version":"0.1.3","license":null,"protocols":["mcp"],"tags":["anthropic","claude","image","mcp","multimodal","vision"],"pricing":null,"endpoints":[{"url":"pypi:claude-vision-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"media.image-understanding","name":"Image Understanding","confidence":1,"provenance":"declared"},{"slug":"security.identity","name":"Identity & Access","confidence":0.825,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev","media","security"],"language":"fr"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"claude-vision-mcp","registry":"pypi","observedAt":"2026-09-09T11:35:22.931Z","publishedAt":"2026-08-14T15:00:39.710534Z","latestVersion":"0.1.3"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"claude-vision-mcp","url":"https://pypi.org/project/claude-vision-mcp/","firstSeenAt":"2026-09-09T11:30:54.356Z","fetchedAt":"2026-09-09T11:30:54.356Z","normalizedAt":"2026-09-09T11:30:54.356Z"}]},"firstSeenAt":"2026-09-09T11:30:54.356Z","updatedAt":"2026-09-09T11:35:22.931Z"}