Skip to main content
Glama
softvoyagers

fakturka-api-mcp

by softvoyagers

MCP-сервер Faktuj

npm version Website API Status

Интегрируйте Faktuj в Claude, Cursor, VS Code и любой другой ИИ-ассистент с поддержкой MCP. Создавайте счета-фактуры (VAT) и счета-проформы, ищите компании по NIP, проверяйте курсы валют NBP и проверяйте номера IBAN — всё прямо из вашего рабочего процесса с ИИ. Полное соответствие требованиям KSeF.

API-ключ не требуется. Бесплатно навсегда.

Быстрый старт

Добавьте в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "faktuj": {
      "command": "npx",
      "args": ["-y", "faktuj-mcp"]
    }
  }
}

Или установите глобально:

npm install -g faktuj-mcp

Затем добавьте в конфигурацию:

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

Related MCP server: mcp-ksef-pl

Доступные инструменты

Инструмент

Описание

generate_invoice

Создание PDF-файла польского счета-фактуры (VAT). Передайте полный JSON счета с данными продавца, покупателя и позициями. Возвращает номер счета и PDF в формате base64.

generate_proforma

Создание PDF-файла счета-проформы. Схема такая же, как у счета-фактуры. Возвращает номер счета и PDF в формате base64.

preview_invoice

Предварительный просмотр и проверка данных счета без создания PDF. Возвращает проверенные данные или ошибки валидации.

lookup_nip

Поиск польской компании по идентификационному номеру налогоплательщика (NIP). Возвращает название компании, адрес и регистрационные данные.

lookup_nbp_rate

Поиск курса валют NBP (Национального банка Польши) для заданной валюты и даты.

validate_iban

Проверка номера IBAN. Возвращает результат проверки и банковские реквизиты, если номер корректен.

Примеры использования

Спросите вашего ИИ-ассистента:

  • "Создай счет-фактуру (VAT) от ACME sp. z o.o. (NIP: 1234567890) для Beta S.A. за 10 часов консультаций по 200 PLN/ч"

  • "Найди компанию с NIP 5263442510"

  • "Какой был курс EUR/PLN на 2026-03-20?"

  • "Проверь IBAN PL61109010140000071219812874"

Архитектура

AI Assistant <--stdio--> faktuj-mcp <--HTTPS--> faktuj.pl REST API

Это тонкий транспортный слой MCP (stdio) поверх REST API Faktuj. MCP-сервер преобразует вызовы инструментов в HTTP-запросы и возвращает структурированные ответы.

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

Переменная окружения

По умолчанию

Описание

FAKTUJ_API_URL

https://faktuj.pl

Базовый URL для API Faktuj

Ресурсы

Экосистема SoftVoyagers

Faktuj является частью портфолио проектов с открытым исходным кодом SoftVoyagers:

Продукт

Описание

Веб-сайт

LinkMeta

Бесплатный API для извлечения метаданных URL

linkmeta.dev

PageShot

Бесплатный API для создания скриншотов и захвата веб-страниц

pageshot.site

PDFSpark

Бесплатный API для конвер

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    MCP server for DACH e-invoicing. Create XRechnung (UBL) and ZUGFeRD 2.3 (Factur-X CII) invoices, validate against EN 16931 rules, extract data from XML, and convert between UBL, CII and JSON formats.
    6
    45 npm
    2
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Model Context Protocol (MCP) server for Polish Electronic Invoicing (KSeF / FA(2)). Provides tools to validate, generate, and explore API specifications for KSeF interoperability.
    10
    3
    Apache 2.0
  • A
    license
    Not graded
    quality
    D
    maintenance
    MCP server for the Invapi E-Invoicing API, enabling conversion, validation, and extraction of invoices in UBL, CII, ZUGFeRD, Excel, and more.
    48 npm
    MIT