{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_hw5fpfg9fmpa","handle":"mcp-vision","url":"https://wellknown.network/agents/mcp-vision","links":{"self":"https://wellknown.network/agents/mcp-vision/record.json","html":"https://wellknown.network/agents/mcp-vision","markdown":"https://wellknown.network/agents/mcp-vision/record.md","api":"https://wellknown.network/api/v1/agents/mcp-vision","status":"https://wellknown.network/api/v1/agents/mcp-vision/status","claim":"https://wellknown.network/agents/mcp-vision/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-vision/claim.json","badge":"https://wellknown.network/agents/mcp-vision/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-vision/history","tools":"https://wellknown.network/api/v1/agents/mcp-vision/tools"},"ard":{"identifier":"urn:air::server:mcp-vision","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-vision","summary":"MCP Server for image recognition - OCR and visual analysis via multimodal APIs, enables image understanding for text-only AI coding tools like Claude Code + DeepSeek","description":"# MCP-OCR\n\n为 Claude Code、Codex CLI、OpenCode 等 AI 编程工具补齐图像识别能力的 MCP Server。\n\n## 解决什么问题\n\nClaude Code 配合 DeepSeek 等**纯文本模型**使用时，无法理解图片内容——截图里的报错、UI 设计稿、手绘架构图、文档扫描件，模型统统\"看不见\"。\n\n**mcp-vision** 作为 MCP Server 插件运行，自动调用多模态视觉 API 完成图像分析，将结果以文本形式返回给 AI 编程工具，让 DeepSeek 等\"看图说话\"。\n\n```\n┌─────────────┐     图片路径/URL      ┌─────────────┐    多模态 API     ┌──────────────┐\n│  AI 编程工具  │ ──────────────────→  │ mcp-vision  │ ──────────────→  │  视觉模型 API  │\n│ Claude Code  │                      │  MCP Server  │                  │ 硅基流动/阿里.. │\n│  Codex CLI   │ ←──────────────────  │             │ ←──────────────  │              │\n│   OpenCode   │     文字分析结果      │             │     图片分析结果   │              │\n└─────────────┘                      └─────────────┘                  └──────────────┘\n```\n\n## 工具说明\n\n| 工具 | 用途 | 底层 |\n|------|------|------|\n| `analyze_image` | 图片内容分析（描述、问答、图表解读） | 多模态 LLM |\n| `ocr_extract` | 从图片/PDF 提取文字（自然语言返回） | 多模态 LLM |\n| `ocr_precise` | 精准 OCR（结构化结果，含坐标和置信度） | 传统 OCR 引擎 |\n\n所有工具均支持**本地文件路径**和**远程 URL**。\n\n## 快速开始\n\n### 安装\n\n```bash\npip install mcp-vision\n```\n\n或使用 uv：\n\n```bash\nuv pip install mcp-vision\n```\n\n### 最简配置\n\n只需一个 API Key 即可运行。推荐使用硅基流动（SiliconFlow），注册即送免费额度：\n\n```bash\n# 注册地址：https://cloud.siliconflow.cn\nSILICONFLOW_API_KEY=sk-your-key\n```\n\n### 配置 AI 编程工具\n\n#### Claude Code\n\n`~/.claude/settings.json`：\n\n```json\n{\n  \"mcpServers\": {\n    \"mcp-vision\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-vision\"],\n      \"env\": {\n        \"SILICONFLOW_API_KEY\": \"sk-your-key\"\n      }\n    }\n  }\n}\n```\n\n#### Codex CLI\n\n`~/.codex/config.toml`：\n\n```toml\n[mcp_servers.mcp-vision]\ncommand = \"uvx\"\nargs = [\"mcp-ocr\"]\n\n[mcp_servers.mcp-vision.env]\nSILICONFLOW_API_KEY = \"sk-your-key\"\n```\n\n#### Cursor\n\n`.cursor/mcp.json`：\n\n```json\n{\n  \"mcpServers\": {\n    \"mcp-vision\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-vision\"],\n      \"env\": {\n        \"SILICONFLOW_API_KEY\": \"sk-your-key\"\n      }\n    }\n  }\n}\n```\n\n#### OpenCode\n\n`opencode.json`：\n\n```json\n{\n  \"mcp\": {\n    \"mcp-vision\": {\n      \"type\"…","publisher":{"name":"hahahahanb","url":null},"homepage":null,"repository":"https://github.com/hahahahanb/mcp-vision","version":"1.0.1","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:mcp-vision","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","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"media.image-understanding","name":"Image Understanding","confidence":1,"provenance":"derived"}],"categories":["media"],"language":"en"},"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":"mcp-vision","registry":"pypi","observedAt":"2026-10-22T12:27:00.061Z","publishedAt":"2026-06-04T07:20:04.012356Z","latestVersion":"1.0.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-vision","url":"https://pypi.org/project/mcp-vision/","firstSeenAt":"2026-09-10T05:21:49.429Z","fetchedAt":"2026-10-22T12:25:39.008Z","normalizedAt":"2026-10-22T12:25:39.008Z"}]},"firstSeenAt":"2026-09-10T05:21:49.429Z","updatedAt":"2026-10-22T12:27:00.061Z"}