Vision Bridge MCP

功能

提供 3 个 MCP 工具：

• describe_image：详细描述图片内容（对象、场景、文字、人物动作、颜色、布局等）。
• extract_image_text：提取图片中的所有文字（OCR）。
• ask_about_image：针对图片回答具体问题。

支持四种图片输入方式：

• image_url：图片 URL
• image_path：本地图片路径
• image_base64：Base64 编码的图片数据
• image：Messages API 格式的图片内容块，例如：

{
  "type": "image",
  "source": {
    "type": "base64",
    "media_type": "image/png",
    "data": "iVBORw0KGgo..."
  }
}

支持的 API 格式（Provider）

| Provider | 说明 | 默认 Endpoint | |----------|------|---------------| | anthropic | Anthropic Messages API | /v1/messages | | openai | OpenAI Chat Completions API | /chat/completions | | gemini | Gemini Native generateContent API | /v1beta/models/{model}:generateContent |

通过 PROVIDER 环境变量切换 API 格式。

快速开始

全局安装

npm install -g @shen866/vision-bridge-mcp

本地开发

git clone https://github.com/shen866/vision-bridge-mcp.git
cd vision-bridge-mcp
npm install
npm run build

配置 Claude Code

API_KEY、BASE_URL、MODEL 为必填项。

Anthropic Messages

{
  "mcpServers": {
    "vision_bridge": {
      "command": "npx",
      "args": ["-y", "@shen866/vision-bridge-mcp"],
      "env": {
        "API_KEY": "your-api-key",
        "BASE_URL": "https://api.anthropic.com",
        "MODEL": "claude-3-5-sonnet-20241022"
      }
    }
  }
}

如果使用本地构建版本，将 command 改为 node 并把 args 改为绝对路径：

{
  "mcpServers": {
    "vision_bridge": {
      "command": "node",
      "args": ["/Users/shen/workspace/kimi-vision-mcp/dist/index.js"],
      "env": {
        "API_KEY": "your-api-key",
        "BASE_URL": "https://api.anthropic.com",
        "MODEL": "claude-3-5-sonnet-20241022"
      }
    }
  }
}

OpenAI Chat Completions

{
  "mcpServers": {
    "vision_bridge": {
      "command": "npx",
      "args": ["-y", "@shen866/vision-bridge-mcp"],
      "env": {
        "PROVIDER": "openai",
        "API_KEY": "your-api-key",
        "BASE_URL": "https://api.openai.com/v1",
        "MODEL": "gpt-4o"
      }
    }
  }
}

Gemini Native generateContent

{
  "mcpServers": {
    "vision_bridge": {
      "command": "npx",
      "args": ["-y", "@shen866/vision-bridge-mcp"],
      "env": {
        "PROVIDER": "gemini",
        "API_KEY": "your-api-key",
        "BASE_URL": "https://generativelanguage.googleapis.com",
        "MODEL": "gemini-1.5-pro-latest"
      }
    }
  }
}

使用

在 Claude Code / Claude Desktop 中发送图片或引用图片路径后，Claude 会自动调用 describe_image 等工具获取多模态模型对图片的文字描述，然后将描述交给纯文本模型继续处理。

如果 Claude Code 经常直接把图片发给模型导致报错，可以在项目根目录创建 .claude/CLAUDE.md：

当前模型不支持图片输入。当用户发送图片时，必须调用 vision_bridge MCP 工具处理，不要直接传给模型。

环境变量

| 变量 | 说明 | 默认值 | |------|------|--------| | PROVIDER | API 格式：anthropic、openai、gemini | anthropic | | API_KEY | API 密钥 | 必填 | | BASE_URL | API 基础地址 | 必填 | | ENDPOINT | API 端点路径 | 取决于 provider | | MODEL | 模型名称 | 必填 | | MAX_TOKENS | 最大输出 token 数 | 4096 | | API_VERSION | Messages API 版本 | 2023-06-01 | | AUTH_HEADER | Messages API 认证方式：x-api-key 或 bearer | x-api-key |

协议

基于 MCP（Model Context Protocol）JSON-RPC 2.0，通过 stdio 进行通信。

401 排查

如果返回 401，通常是认证头不对。各 provider 默认认证方式如下：

• anthropic：x-api-key + anthropic-version
• openai：Authorization: Bearer
• gemini：URL query parameter ?key=

如果 Messages API 网关需要 Bearer Token，可设置：

"AUTH_HEADER": "bearer"