scan-mcp — MCP-сервер для Claude Code: сканирование документов
MCP-сервер для поиска сканеров и пакетного захвата через SANE. Пригодится, когда нужно превратить стопку бумаг в TIFF-файлы прямо из чата с агентом.
claude mcp add scan-mcp -- npx -y scan-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, но аутентификации в нём нет — только для внутренней сети.
Какие задачи решает
- найти подключённый сканер и посмотреть его параметры SANE
- отсканировать пачку документов через ADF в один проход
- собрать многостраничный TIFF из отдельных страниц
- разрезать страницы по карательным листам и сохранить производные
- посмотреть статус и журнал событий задачи сканирования
Примеры запросов агенту
- Найди сканеры и покажи, какие у них настройки
- Запусти сканирование через ADF в 300 dpi и собери многостраничный TIFF
- Покажи статус последней задачи сканирования и её журнал
Как установить scan-mcp
Командой платформы
claude mcp add scan-mcp -- npx -y scan-mcpКомандой платформы
codex mcp add scan-mcp -- npx -y scan-mcpФайл настроек
{
"mcpServers": {
"scan-mcp": {
"command": "npx",
"args": [
"-y",
"scan-mcp"
]
}
}
}Файл настроек
{
"servers": {
"scan-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"scan-mcp"
]
}
}
}Командой платформы
gemini mcp add scan-mcp npx -y scan-mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о scan-mcp
Как установить scan-mcp в Claude Code?
Одной командой: claude mcp add scan-mcp -- npx -y scan-mcp. После этого сервер запускается через npx при старте клиента.
Что делает scan-mcp?
Ищет подключённые сканеры, запускает задачи сканирования и собирает страницы в многостраничные TIFF. Управление идёт через инструменты MCP прямо из агента.
Что нужно для работы scan-mcp?
Linux с утилитами SANE (scanimage) и инструментами для TIFF: tiffcp или ImageMagick convert. Ещё нужен Node 22.
