
dangpolly927-eng/mcp-vision-web-bridge
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
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:
.envis 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": [
설치
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"
]
}
}
}