Skip to main content
Glama
shen866

Vision Bridge MCP

by shen866
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

Vision Bridge MCP

通用视觉 MCP 服务器，支持多种多模态 API 格式。当 Claude Code / Claude Desktop 使用的模型无法直接处理图片时，可通过该 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..."
  }
}

Related MCP server: read-image-mcp

支持的 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"
Install Server
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/shen866/vision-bridge-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server