snip-mcp

MCP-сервер, который позволяет захватывать области экрана непосредственно в ваши диалоги Claude Code. Выберите любую область экрана с помощью горячей клавиши или вызова инструмента, и скриншот будет немедленно доступен в контексте как изображение.

Возможности

• Захват горячими клавишами -- Ctrl+Shift+Клик открывает оверлей для выделения области в любом месте и в любое время

• Захват через инструменты -- Claude может вызвать инструмент захвата от вашего имени

• Поддержка нескольких мониторов -- работает на всех подключенных дисплеях с учетом DPI

• Постоянное хранилище -- снимки сохраняются на диске и остаются после перезапуска сервера

• Автоматическая очистка -- настраиваемый лимит предотвращает бесконечный рост объема хранилища

• Всплывающие уведомления -- визуальное подтверждение при захвате снимка

Related MCP server: Shotik

Требования

• Windows 10 или новее (использует специфичные для Windows глобальные хуки мыши через ctypes)

• Python 3.11+

Установка

git clone https://github.com/Alparse/snip-mcp.git
cd snip-mcp
pip install -e .

Или с помощью uv:

git clone https://github.com/Alparse/snip-mcp.git
cd snip-mcp
uv pip install -e .

Настройка Claude Code

Добавьте сервер в настройки MCP вашего Claude Code.

Если установка выполнена через pip (глобально или в venv)

В файле ~/.claude/settings.json (глобально) или .claude/settings.json (в проекте):

{
  "mcpServers": {
    "snip": {
      "command": "snip-mcp"
    }
  }
}

Если используется uv (рекомендуется для изоляции)

{
  "mcpServers": {
    "snip": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/snip-mcp", "snip-mcp"]
    }
  }
}

Использование

Захват горячими клавишами

Нажмите Ctrl+Shift+Левая кнопка мыши в любом месте экрана, чтобы открыть оверлей для выделения:

1. Нажмите и перетащите, чтобы выбрать область

2. Отпустите кнопку для захвата

3. Нажмите Escape для отмены

Всплывающее уведомление подтвердит захват.

Захват через инструменты

Попросите Claude сделать скриншот — он вызовет инструмент snip_screen и откроет для вас оверлей.

Управление снимками

Claude доступны следующие инструменты MCP:

Конфигурация

Конфигурация хранится в ~/.snip_mcp/config.json и создается автоматически при первом запуске.

Пример конфигурации:

{
  "modifier_keys": ["ctrl", "shift"],
  "save_directory": "C:/Users/you/.snip_mcp/snips",
  "overlay_alpha": 0.3,
  "selection_color": "#00ff00",
  "selection_width": 2,
  "max_snips": 50
}

Устранение неполадок

"snip-mcp requires Windows" Этот сервер использует специфичные для Windows API (глобальные хуки мыши через ctypes). Он не может работать в macOS или Linux.

"Failed to install mouse hook" Глобальный хук мыши может потребовать повышенных привилегий. Попробуйте запустить терминал от имени администратора.

Оверлей не появляется Убедитесь, что никакое другое приложение не перехватывает Ctrl+Shift+Клик. Проверьте modifier_keys в вашей конфигурации.

Координаты смещены на дисплеях с высоким DPI Сервер вызывает SetProcessDPIAware() при запуске. Если вы все еще видите проблемы со смещением, проверьте настройки масштабирования дисплея в Windows.

Директория снимков По умолчанию снимки хранятся в ~/.snip_mcp/snips/. Вы можете изменить это в config.json.

Лицензия

MIT -- подробности см. в LICENSE.