gofact — MCP-сервер для Claude Code: счёт-фактуры Factur-X
Локальный MCP-сервер, который превращает HTML-счёт в Factur-X: PDF/A-3 с встроенным XML по EN 16931. Для французских фрилансеров и малых фирм.
Открыть на GitHubЧто делает gofact
gofact — небольшая программа на Go. Она берёт готовый к печати HTML-счёт и собирает из него Factur-X: PDF/A-3, внутрь которого упакован XML CII по EN 16931. По желанию счёт уходит на французскую платформу PDP.
Проверок две. Сначала правила EN 16931 прогоняются по модели до того, как что-то создано: несоответствующий счёт не выпускается, а в ответе приходит код правила вроде BR-50 и поле, которое надо поправить. Потом готовый PDF перечитывается: проверяются структуры Factur-X (/AF, /OutputIntents, XMP, /EmbeddedFiles), а вложенный XML сравнивается с созданным побайтово. XML встраивается как есть, без повторной сериализации через собственную модель — иначе теряются расширенные поля, в том числе адреса электронной маршрутизации PDP.
Из системных зависимостей нужен только браузер: Chrome, Edge, Brave или Chromium для рендеринга HTML в PDF. Пакеты в песочнице вроде snap и flatpak пропускаются, потому что не видят временные файлы. Сборка PDF/A-3 идёт на Go через pdfcpu, профиль sRGB ICC зашит в бинарник. Продавец, IBAN и учётные данные PDP берутся из окружения; без настроенного продавца gofact падает с явной ошибкой, а не выпускает неполный счёт.
Какие задачи решает
- собрать Factur-X из HTML-шаблона и данных заказа
- проверить счёт по правилам EN 16931 до выпуска
- отправить готовый счёт на французскую платформу PDP
- вести сквозную нумерацию счетов без пропусков
- сверить вложенный XML с исходным после сборки PDF
Примеры запросов агенту
- Сделай счёт для ACME, 2 дня по 600 евро
- Покажи следующий номер счёта и собери Factur-X из
facture.html - Отправь счёт
2026011 - Client.pdfна PDP и покажи статус
Как установить gofact
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о gofact
Как установить gofact в Claude Code?
Соберите бинарник командой go build -o gofact ., затем зарегистрируйте сервер: claude mcp add gofact -- /path/to/gofact mcp.
Что делает gofact?
Собирает Factur-X: PDF/A-3 с встроенным XML CII по EN 16931, проверяет счёт по бизнес-правилам и при необходимости отправляет его на платформу PDP.
Что нужно для работы gofact?
Браузер для рендеринга HTML в PDF — Chrome, Edge, Brave или Chromium. Продавец, IBAN и данные PDP задаются переменными окружения в .env.
