Skip to main content
Glama
deenesjakoruzh
1042498283

vision-mcp

by 1042498283
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Luma MCP

    JochenYang
    A
    license
    A
    quality
    A
    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
    529 npm
    115
    MIT

  • qwen-vision-mcp

    Bigcheese18
    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

  • llm-vision

    maple-red
    A
    license
    Not graded
    quality
    C
    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.
    7 npm
    Apache 2.0