vision-mcp

Визуальный MCP-сервер на основе Alibaba Cloud Bailian DashScope (Qwen-VL). Обеспечивает понимание изображений для клиентов, таких как Claude Code, Trae, CodeBuddy, по протоколу MCP.

Функции

• analyze_image — общий анализ изображений (поддерживает локальные пути к файлам / публичные URL / data URL)

• screenshot_analyze — анализ UI / скриншотов интерфейса

Related MCP server: image-mcp

Поддерживаемые модели

Быстрый старт

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-你的密钥

Для получения ключа: Консоль Alibaba Cloud Bailian

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

Примечания

• При загрузке публичных URL изображений из-за рубежа сервер DashScope может превысить таймаут. Рекомендуется использовать локальные пути к файлам или URL, доступные из Китая.

• API-ключ передается через файл .env и не записывается в конфигурационные файлы.

Лицензия

MIT