Skip to main content
Glama

vision-mcp

阿里云百炼 DashScope (Qwen-VL) 기반의 비전 MCP 서버입니다. MCP 프로토콜을 통해 Claude Code, Trae, CodeBuddy 등 클라이언트에 이미지 이해 기능을 제공합니다.

기능

  • analyze_image — 일반 이미지 분석 (로컬 파일 경로 / 공용 URL / data URL 지원)

  • screenshot_analyze — UI / 인터페이스 스크린샷 분석

Related MCP server: image-mcp

지원되는 모델

모델

설명

qwen-vl-max

최고 성능, 복잡한 이미지 이해에 적합

qwen-vl-plus

성능과 속도 균형 (기본값)

qwen2.5-vl-72b-instruct

72B 명령어 따르기

qwen2.5-vl-7b-instruct

7B 경량 빠름

빠른 시작

1. 의존성 설치

python -m venv .venv
# Windows
.venv\Scripts\pip install -r requirements.txt
# Linux / macOS
.venv/bin/pip install -r requirements.txt

2. API 키 구성

프로젝트 루트 디렉토리에 .env 파일을 생성합니다 (MCP 서버 시작 시 자동 로드):

DASHSCOPE_API_KEY=sk-你的密钥

신청 주소: 阿里云百炼控制台

3. 실행

# Windows
.venv\Scripts\python vision_mcp_server.py
# Linux / macOS
.venv/bin/python vision_mcp_server.py

지원되는 모델 목록:

python vision_mcp_server.py --list

MCP 클라이언트 연동

클라이언트의 MCP 구성 (예: mcp.json 또는 .mcp.json)에 다음을 추가합니다:

{
  "mcpServers": {
    "vision": {
      "command": "/path/to/vision-mcp/.venv/bin/python",
      "args": ["/path/to/vision-mcp/vision_mcp_server.py"],
      "env": {}
    }
  }
}

테스트

# 协议冒烟测试(无需 API Key)
.venv/bin/python smoke_test.py

# 真实调用测试(需配置 API Key,使用本地测试图)
.venv/bin/python live_test.py

주의사항

  • DashScope 서버가 해외 공용 이미지 URL을 다운로드할 때 시간 초과가 발생할 수 있으므로, 로컬 파일 경로 또는 국내에서 접근 가능한 URL을 사용하는 것이 좋습니다.

  • API 키는 .env 파일을 통해 제공되며, 구성 파일에 기록되지 않습니다.

라이선스

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Multi-model vision understanding MCP server that provides unified image analysis for AI assistants without native vision, supporting models like GLM-4.6V, DeepSeek-OCR, Qwen3-VL-Flash, and more.
      1
      512 npm
      116
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server that adds Qwen3-VL vision capabilities to Claude Code or any MCP client, enabling OCR, UI/screenshot recognition, and chart understanding. It provides tools for analyzing single or batch images via DashScope's OpenAI-compatible API, with caching and fast mode.
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP server that provides a 'borrowed eye' for text-only LLMs, enabling them to identify and describe local images via the Qwen VL vision model, including face recognition, scene description, OCR, and targeted visual questioning.
      -