DE

dangpolly927-eng/mcp-vision-web-bridge

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

36 stars 0 forks 품질 72 트렌드 12MIT

OpenAI 호환 모델과 이미지 이해 및 웹 페이지 읽기를위한 로컬 MCP 브리지

개요

Claude Desktop, Claude Code 및 기타 MCP 클라이언트 두 가지 실용적인 브리지 도구를 제공하는 로컬 MCP 서버: - 최근 Claude 업로드, 클립보드, 로컬 경로, URL, 또는 base64 입력에서 이미지를 읽은 다음 OpenAI 호환 비전 모델로 보내; - 로컬 웹 링크를 읽고, 읽기 쉬운 텍스트를 추출 한 다음 OpenAI 호환 모델에 결과를 보냅니다. 모델이나 모델 크레딧이 포함되지 않습니다. OpenAI-compatible API 엔드포인트와 API 키를 가져옵니다. - Claude 클라이언트는 이미지를 받아들일 수 있지만, 세 번째 파티 모델은 이미지 콘텐츠를 믿을 수 없습니다. - - - 당신의 모형 공급자는 시각을 지원하고, 그러나 당신의 MCP 클라이언트는 이미지를 입력하는 국부적으로 공구를 필요로 합니다. - - - 당신은 기본적으로 활성화된 private-network 차단을 가진 더 안전한 국부적으로 웹 독자를 원합니다. 최근 Claude 업로드 경로는 안정적인 공개 API가 아닌 클라이언트 구현 세부 사항입니다. 자동 감지가 환경에 작동하지 않는 경우 CLAUDE UPLOAD DIRS를 수동으로 설정하십시오.

개요(AI 번역)

Claude Desktop, Claude Code 및 기타 MCP 클라이언트 두 가지 실용적인 브리지 도구를 제공하는 로컬 MCP 서버:

  • 최근 Claude 업로드, 클립보드, 로컬 경로, URL, 또는 base64 입력에서 이미지를 읽은 다음 OpenAI 호환 비전 모델에 보냅니다.
  • 로컬 웹 링크를 읽고, 읽기 쉬운 텍스트를 추출 한 다음 OpenAI 호환 모델에 결과를 보냅니다.

모델이나 모델 크레딧이 포함되지 않습니다. OpenAI-compatible API 엔드포인트와 API 키를 가져옵니다.

사용 케이스

  • Claude 클라이언트는 이미지를 받아들일 수 있지만, 세 번째 파티 모델은 이미지 콘텐츠를 믿을 수 없습니다.
  • 당신의 모형 공급자는 시각을 지원하고, 그러나 당신의 MCP 클라이언트는 이미지 입력을 모으는 국부적으로 공구를 필요로 합니다.
  • 당신은 기본적으로 활성화된 private-network 차단을 가진 더 안전한 국부적으로 웹 독자를 원합니다.

기능

| 기능 | macOS | 윈도우 | 리눅스 | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | MCP 서버 | 지원 | 지원 | 지원 | | OpenAI 호환 채팅 완료 | 지원 | 지원 | 지원 | 지원 | | 지원 | 지원 | 지원 | 지원 | | 최근 클로드 업로드 이미지 | 지원 | 베스트 노력 |

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

mcp-vision-web-bridge

Local MCP server that gives Claude Desktop, Claude Code, and other MCP clients two practical bridge tools:

  • read an image from a recent Claude upload, clipboard, local path, URL, or base64 input, then send it to an OpenAI-compatible vision model;
  • read web links locally, extract readable text, then send the result to an OpenAI-compatible model.

It does not include a model or any model credits. You bring your own OpenAI-compatible API endpoint and API key.

Use Cases

  • Your Claude client can accept images, but the third-party model behind it does not reliably receive image content.
  • Your model provider supports vision, but your MCP client needs a local tool to collect image inputs.
  • You want a safer local web reader with private-network blocking enabled by default.

Capabilities

Capability macOS Windows Linux
MCP server Supported Supported Supported
OpenAI-compatible chat completions Supported Supported Supported
Web page reading Supported Supported Supported
Recent Claude upload image Supported Best effort Best effort
Clipboard image Supported Supported via PowerShell / Windows Forms Supported via wl-paste or xclip

Recent Claude upload paths are client implementation details, not a stable public API. If auto-detection does not work in your environment, set CLAUDE_UPLOAD_DIRS manually.

Security Defaults

The default configuration is intentionally conservative:

  • .env is ignored and should never be committed.
  • API keys are only read from environment variables.
  • Explicit local image paths are disabled unless ALLOW_LOCAL_IMAGE_PATHS=true.
  • Clipboard image reading is disabled unless ALLOW_CLIPBOARD_IMAGES=true.
  • Private-network web and image URLs are disabled unless ALLOW_PRIVATE_NETWORK_URLS=true.
  • Jina Reader fallback is disabled unless USE_JINA_READER=true.
  • The server does not log prompts, image data, API keys, or fetched page bodies.

Requirements

  • Node.js 20 or newer
  • npm

This is a Node.js project. It does not require Python or a virtual environment.

Install

npm install
cp .env.example .env

Edit .env:

MODEL_BASE_URL=https://api.example.com/v1
MODEL_API_KEY=replace-with-your-own-key
MODEL_NAME=replace-with-your-vision-model

ALLOW_LOCAL_IMAGE_PATHS=false
ALLOW_CLIPBOARD_IMAGES=false
ALLOW_PRIVATE_NETWORK_URLS=false
USE_JINA_READER=false
MAX_IMAGE_BYTES=10485760

MODEL_BASE_URL must be an OpenAI-compatible /v1 endpoint.

SiliconFlow Example

MODEL_BASE_URL=https://api.siliconflow.cn/v1
MODEL_API_KEY=replace-with-your-own-key
MODEL_NAME=Qwen/Qwen3-VL-8B-Instruct

Use a model that supports vision input.

Claude Desktop Config

Use absolute paths for your local checkout:

{
  "mcpServers": {
    "vision-web-bridge": {
      "command": "node",
      "args": [
GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "vision-web-bridge": { "command": "node", "args": [ "--env-file-if-exists=/absolute/path/to/mcp-vision-web-bridge/.env", "/absolute/path/to/mcp-vision-web-bridge/src/server.mjs" ] } } }