# scan-mcp

MCP-сервер для поиска сканеров и пакетного захвата через SANE. Пригодится, когда нужно превратить стопку бумаг в TIFF-файлы прямо из чата с агентом.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Автор: jacksenechal
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/jacksenechal/scan-mcp
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/mcp/scan-mcp

## Что делает

scan-mcp даёт агенту инструменты для работы со сканером: `list_devices` находит подключённые устройства, `get_device_options` показывает их параметры SANE, `start_scan_job` запускает задачу. Если не указать `device_id`, сервер сам выберет сканер — предпочтёт ADF или дуплекс и не тронет камерные бэкенды. По умолчанию 300 dpi; при разрешении от 600 dpi цветовой режим переключается на `Color`, потому что на такой плотности обычно сканируют изображения, а не текст.

Результаты складываются в `INBOX_DIR` по задачам: страницы `page_*.tiff`, собранные документы `doc_*.tiff`, `manifest.json` и журнал `events.jsonl`. Многостраничная сборка идёт через `tiffcp`, а если его нет — через ImageMagick `convert`. Статус, отмена и список задач доступны через `get_job_status`, `cancel_job` и `list_jobs`.

Работает это на Linux с утилитами SANE: нужен `scanimage`, а для сборки — `tiffcp` или `convert`. Пакет рассчитан на Node 22. Без этих бинарников в `PATH` сервер не запустится, так что сначала проверьте систему. Транспорт по умолчанию stdio, всё остаётся на одной машине; есть и HTTP-режим через `scan-mcp --http` на порту `3001`, но аутентификации в нём нет — только для внутренней сети.

## Требования
- Нужно: Node.js (команды через npx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add scan-mcp -- npx -y scan-mcp
```

### Codex

**Командой платформы**
```bash
codex mcp add scan-mcp -- npx -y scan-mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "scan-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "scan-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "scan-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "scan-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add scan-mcp npx -y scan-mcp
```

## Когда брать
- найти подключённый сканер и посмотреть его параметры SANE
- отсканировать пачку документов через ADF в один проход
- собрать многостраничный TIFF из отдельных страниц
- разрезать страницы по карательным листам и сохранить производные
- посмотреть статус и журнал событий задачи сканирования

## Примеры запросов агенту
- Найди сканеры и покажи, какие у них настройки
- Запусти сканирование через ADF в 300 dpi и собери многостраничный TIFF
- Покажи статус последней задачи сканирования и её журнал

## Похожие
- [Scrapling MCP Server](https://affpapa.org/nevibecode/mcp/scrapling-mcp-server.md) — MCP-сервер · ★ 89433
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [AIHawk](https://affpapa.org/nevibecode/mcp/aihawk.md) — MCP-сервер · ★ 32221
- [Skyvern](https://affpapa.org/nevibecode/mcp/skyvern.md) — MCP-сервер · ★ 23263
- [SeleniumBase MCP](https://affpapa.org/nevibecode/mcp/seleniumbase-mcp.md) — MCP-сервер · ★ 13169
- [Inbox Zero](https://affpapa.org/nevibecode/mcp/inbox-zero.md) — MCP-сервер · ★ 12791

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
