
dangpolly927-eng/mcp-vision-web-bridge
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
ローカルMCPブリッジで、OpenAI対応モデルで画像の理解とWebページの読み込みが可能
概要
Claude デスクトップ、Claude コードおよび他の MCP クライアントに 2 つの実用的な橋道具を与えるローカル MCP サーバー: - 最近のClaudeアップロード、クリップボード、ローカルパス、URL、またはbase64入力から画像を読み、OpenAI互換ビジョンモデルに送信します。 - Webリンクをローカルで読み、読みやすいテキストを抽出し、結果をOpenAI互換モデルに送信します。 モデルやモデルのクレジットは含まれません。 独自の OpenAI 互換 API エンドポイントと API キーを持たせます。 - Claudeクライアントはイメージを受け入れることができますが、それの背後にあるサードパーティのモデルは、確実にイメージコンテンツを受け取りません。 ・ お使いのモデルプロバイダは、ビジョンをサポートしていますが、MCP クライアントは、画像入力を収集するためのローカルツールが必要です。 ・ ローカルWebリーダーをプライベートネットワークブロックで保護したい。デフォルトで有効になっています。 最近のClaudeアップロードパスは、クライアントの実装の詳細であり、安定した公開APIではありません。 auto-detectionが環境で動作しない場合は、手動でCLAUDE UPLOAD DIRSを設定してください.
概要(AI 翻訳)
Claude デスクトップ、Claude コードおよび他の MCP クライアントに 2 つの実用的な橋道具を与えるローカル MCP サーバー:
- 最近のClaudeアップロード、クリップボード、ローカルパス、URL、またはbase64入力から画像を読み、OpenAI互換ビジョンモデルに送信します。
- ローカルにWebリンクを読み込み、読みやすいテキストを抽出し、結果をOpenAI互換モデルに送信します。
モデルやモデルのクレジットは含まれません。 独自の OpenAI 互換 API エンドポイントと API キーを持たせます。
ユースケース
- Claudeクライアントはイメージを受け入れることができますが、それの背後にあるサードパーティのモデルは、確実にイメージコンテンツを受け取りません。
- あなたのモデル・プロバイダは視野を支えますが、あなたのMCPの顧客はイメージの入力を集めるローカル ツールを必要とします。
- デフォルトで有効にされているプライベートネットワークブロックを備えた安全なローカルWebリーダーが必要です。
機能
| 機能 | macOS | macOS | ウィンドウズ | Linux | | お問い合わせ | | MCPサーバー | 対応 | 対応 | 対応 | | OpenAI対応チャット完了 | 対応 | 対応 | 対応 | | Webページの読み込み | 対応 | 対応 | 対応 | | 最近のクロードアップロード画像 | 対応 | 最善の努力 | 最善の努力 |
このページは 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"
]
}
}
}