vision-mcp

A visual MCP Server based on Alibaba Cloud Bailian DashScope (Qwen-VL). Provides image understanding capabilities for clients such as Claude Code, Trae, and CodeBuddy via the MCP protocol.

Features

• analyze_image — General image analysis (supports local file paths / public URLs / data URLs)

• screenshot_analyze — UI / interface screenshot analysis

Related MCP server: image-mcp

Supported Models

Quick Start

1. Install Dependencies

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

2. Configure API Key

Create a .env file in the project root (automatically read when MCP Server starts):

DASHSCOPE_API_KEY=sk-你的密钥

Application URL: Alibaba Cloud Bailian Console

3. Start

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

List supported models:

python vision_mcp_server.py --list

Connect to MCP Client

Add the following to the client's MCP configuration (e.g., mcp.json or .mcp.json):

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

Testing

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

# 真实调用测试（需配置 API Key，使用本地测试图）
.venv/bin/python live_test.py

Notes

• The DashScope server may time out when downloading overseas public image URLs. It is recommended to use local file paths or URLs accessible within China

• The API Key is provided via the .env file and is not written into the configuration file

License

MIT