DeepSeek Vision MCP Server

FastMCP로 구축된 DeepSeek 비전 MCP 서버로, opencode 같은 MCP 클라이언트를 위해 공식 비전 가이드의 세 가지 이미지 입력 인터페이스를 구현합니다.

• 모델: deepseek-v4-flash-vision-exp

• API: OpenAI 호환 형식, base_url = https://api.deepseek.com

중국어 문서는 README.zh.md를 참조하세요.

인터페이스

detail 옵션: low(512×512로 크기 조정, 더 빠르고 저렴), high, original, auto.

Related MCP server: Vision MCP Server

설치

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 섹션에 다음을 추가하세요:

"deepseek-vision": {
  "type": "local",
  "command": ["C:\\Users\\%USERNAME%\\mcp\\DeepSeek\\.venv\\Scripts\\python",
    "C:\\Users\\%USERNAME%\\mcp\\DeepSeek\\server.py"],
  "enabled": true,
  "environment": {
    "DEEPSEEK_API_KEY": "<your DeepSeek API key>"
  }
}

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를 사용해 그 안의 텍스트를 읽어 줘"

제한 치트 시트

참고:

• 이미지는 user 메시지에만 포함할 수 있습니다. system / assistant 메시지의 이미지는 400 오류를 반환합니다.

• 이미지를 받을 수 있는 모델은 비전 모델뿐입니다. 다른 모델은 "This model does not support image"를 반환합니다.

• 모든 이미지는 모델에 들어가기 전에 크기가 조정되며, 단일 이미지는 최대 ~384토큰을 소비합니다.

검증

%HOMEPATH%\mcp\DeepSeek\.venv\Scripts\python %HOMEPATH%\mcp\DeepSeek\server.py

오류가 없으면 서버가 stdio 모드에서 정상적으로 시작됩니다(실제 호출에는 DEEPSEEK_API_KEY 구성이 필요합니다).