Paperless-NGX MCP Server
Сервер для взаимодействия с API Paperless-NGX, управления документами, тегами и типами документов.
Описание
Это MCP-сервер на TypeScript для интеграции с Paperless-NGX API. Предоставляет инструменты для поиска, загрузки, редактирования документов, создания тегов, корреспондентов и типов документов. Поддерживает bulk-операции, такие как слияние, разделение и поворот страниц. Построен с использованием litemcp для MCP-протокола и zod для валидации схем. Идеален для автоматизации документооборота через AI-ассистентов вроде Claude.
Возможности
Управление документами
Листинг, поиск, скачивание, загрузка новых документов и bulk-операции (слияние, разделение, поворот, удаление страниц).
Работа с тегами
Список всех тегов и создание новых с цветом, паттернами匹配 и алгоритмами.
Корреспонденты и типы документов
Получение списка и создание корреспондентов/типов документов с матчингом по тексту.
Кастомные поля
Управление полями: создание, обновление, удаление и bulk-операции для документов.
Установка
Для ручной установки добавьте в MCP-конфиг:
Для STDIO-режима (рекомендуется для локального использования):
{
"paperless": {
"command": "npx",
"args": [
"-y",
"@baruchiro/paperless-mcp@latest"
],
"env": {
"PAPERLESS_URL": "http://your-paperless-instance:8000",
"PAPERLESS_API_KEY": "your-api-token",
"PAPERLESS_PUBLIC_URL": "https://your-public-domain.com"
}
}
}
Для HTTP-режима (рекомендуется для Docker):
{
"paperless": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/baruchiro/paperless-mcp:latest"
],
"env": {
"PAPERLESS_URL": "http://your-paperless-instance:8000",
"PAPERLESS_API_KEY": "your-api-token",
"PAPERLESS_PUBLIC_URL": "https://your-public-domain.com"
}
}
}
Получите API-токен в профиле Paperless-NGX и замените плейсхолдеры. Установите зависимости: npm install, если разрабатываете.