Skip to main content
Glama
vibe-token

DeepSeek Vision MCP Server

by vibe-token

DeepSeek Vision MCP Server

FastMCP で構築された DeepSeek ビジョン MCP サーバーです。opencode などの MCP クライアント向けに、公式 vision guide の3つの画像入力インターフェースを実装しています。

  • モデル: deepseek-v4-flash-vision-exp

  • API: OpenAI 互換形式、base_url = https://api.deepseek.com

中文ドキュメントは README.zh.md を参照してください。

インターフェース

ツール

メソッド

説明

analyze_local_image(image_path, prompt, detail)

1. Base64 インライン

ローカル画像を読み込み、リクエスト内に埋め込む data URL としてエンコードします。画像1枚あたり最大 32 MiB

analyze_image_url(image_url, prompt, detail)

2. 外部 URL

サーバーがダウンロードする公開 http(s) リンクを渡します。URL は 8192 文字以下

analyze_file_id(file_id, prompt)

3. Files API

アップロード済みファイルの file_id を参照します。画像1枚あたり最大 64 MiB、リクエスト間で再利用可能

upload_image(image_path)

Files API ヘルパー

ローカル画像(purpose=user_data)をアップロードし、file-api-... の file_id を返します

detail オプション: low(512×512 にリサイズされ、高速かつ低コスト)、high、original、auto。

Related MCP server: Look At Pic MCP

インストール

mkdir %HOMEPATH%\mcp\DeepSeek
python -m venv %HOMEPATH%\mcp\DeepSeek\.venv
%HOMEPATH%\mcp\DeepSeek\.venv\Scripts\pip install -r %HOMEPATH%\mcp\DeepSeek\requirements.txt

依存パッケージは requirements.txt に固定されています: fastmcp==3.4.7、openai==3.3.1。

設定

%HOMEPATH%\.config\opencode\opencode.jsonc の mcp セクションに以下を追加してください:

GXP2

API キーは DeepSeek Platform から取得してください。

使用例

設定後は、会話で次のように質問するだけです:

  • "analyze_local_image を使って D:\pics\screenshot.png に何が映っているか説明してください"

  • "analyze_image_url を使って https://example.com/photo.jpg を確認し、そのシーンを説明してください"

  • "まず upload_image で big_photo.png をアップロードし、それから analyze_file_id で画像内のテキストを読み取ってください"

制限チートシート

制限

値

対応形式

JPEG, PNG, GIF, WebP

リクエストボディサイズ(インライン)

48 MiB

単一画像(base64 / 外部 URL)

32 MiB

単一画像(Files API)

64 MiB

外部 URL の長さ

8192 文字

1リクエストあたりの最大画像数

600

注記:

  • 画像は user メッセージにのみ含めることができます。system / assistant メッセージ内に画像があると 400 が返ります。

  • 画像を受け付けられるのはビジョンモデルのみです。それ以外のモデルは「This model does not support image」を返します。

  • すべての画像はモデルに入る前にリサイズされます。画像1枚が消費するトークンは最大約384です。

検証

GXP3

エラーがなければ、サーバーは stdio モードで正常に起動します(実際の呼び出しには DEEPSEEK_API_KEY の設定が必要です)。

Related MCP Connectors

Related MCP Servers