de en es ja ko ru zh

mcp-einvoicing-core

Name: mcp-einvoicing-core
Author: cmendezs

by cmendezs

Overview Schema Related Servers Score Discussions

Python

mcp-einvoicing-core

License PyPI version Python

Темы: mcp mcp-server e-invoicing electronic-invoicing european-invoicing python fastmcp peppol en16931 ubl fatturapa xp-z12-013 xml base-library

Базовый пакет для европейских MCP-серверов электронного документооборота.

Предоставляет абстрактные базовые классы, общие модели Pydantic, утилиты для XML и HTTP-клиент, чтобы пакеты для конкретных стран (mcp-facture-electronique-fr, mcp-fattura-elettronica-it и др.) имели общую основу без дублирования кода.

Что предоставляет этот пакет

Модуль	Содержимое	Используется в
`models.py`	`InvoiceParty`, `InvoiceLineItem`, `VATSummary`, `PaymentTerms`, `InvoiceDocument`, `DocumentValidationResult`	IT (генерация структурированных счетов), в будущем BE/PL/DE/ES
`base_server.py`	`BaseDocumentGenerator`, `BaseDocumentValidator`, `BaseDocumentParser`, `BaseLifecycleManager`, `BasePartyValidator`, `EInvoicingMCPServer`	Все адаптеры стран
`xml_utils.py`	`format_amount`, `format_quantity`, `validate_date_iso`, `validate_iban`, `xml_element`, `xml_optional`, `format_error`, `filter_empty_values`	IT (извлечено дословно), будущие форматы на основе XML
`http_client.py`	`TokenCache`, `OAuthConfig`, `BaseEInvoicingClient` (OAuth2 + без авторизации)	FR (извлечено дословно), будущие API-ориентированные страны
`exceptions.py`	`EInvoicingError`, `ValidationError`, `PartyValidationError`, `XSDValidationError`, `DocumentGenerationError`, `AuthenticationError`, `PlatformError`	Все адаптеры стран
`logging_utils.py`	`setup_logging`, `get_logger`	Все адаптеры стран

Related MCP server: mcp-facture-electronique-fr

Установка

pip install mcp-einvoicing-core

Этот пакет не имеет зависимостей, специфичных для конкретных стран. lxml (необходим для XSD-валидации в IT и будущих странах) объявляется каждым пакетом страны отдельно.

Архитектура

mcp-einvoicing-core           ← this package
  ├── BaseDocumentGenerator   ← abstract: generate(InvoiceDocument) → str
  ├── BaseDocumentValidator   ← abstract: validate(xml) → DocumentValidationResult
  ├── BaseDocumentParser      ← abstract: parse(xml) → dict
  ├── BaseLifecycleManager    ← abstract: submit/search/get_status (async HTTP)
  ├── BasePartyValidator      ← abstract: validate_seller/buyer/tax_id
  ├── BaseEInvoicingClient    ← concrete: async HTTP + OAuth2/no-auth/token
  ├── InvoiceDocument (Pydantic)  ← shared data model
  └── EInvoicingMCPServer     ← plugin registry wrapping FastMCP

mcp-facture-electronique-fr   ← country adapter (FR)
  ├── PAConfig(OAuthConfig)
  ├── FlowClient(BaseEInvoicingClient)      ← OAuth2, XP Z12-013 Annex A
  ├── DirectoryClient(BaseEInvoicingClient) ← OAuth2, XP Z12-013 Annex B
  └── FrLifecycleManager(BaseLifecycleManager)

mcp-fattura-elettronica-it    ← country adapter (IT)
  ├── ItalyPartyValidator(BasePartyValidator)   ← Partita IVA modulo-10
  ├── FatturaGenerator(BaseDocumentGenerator)   ← FatturaPA XML v1.6.1
  ├── FatturaValidator(BaseDocumentValidator)   ← lxml XSD v1.6.1
  └── FatturaParser(BaseDocumentParser)         ← lxml xpath

Шаблон регистрации плагинов

Пакеты стран регистрируют свои инструменты в общем или отдельном экземпляре FastMCP:

# Standalone (existing server.py — no changes required)
from fastmcp import FastMCP
mcp = FastMCP(name="mcp-fattura-elettronica-it", instructions="…")
register_header_tools(mcp)
register_body_tools(mcp)
register_global_tools(mcp)

# Multi-country (optional EInvoicingMCPServer)
from mcp_einvoicing_core import EInvoicingMCPServer
server = EInvoicingMCPServer(name="mcp-einvoicing-eu", instructions="…")
server.register_plugin(register_header_tools, "it-header")
server.register_plugin(register_flow_tools, "fr-flow")
server.run()

Совместимость с Claude Desktop / Cursor / Kiro

Существующие конфигурации для mcp-facture-electronique-fr и mcp-fattura-elettronica-it не требуют изменений: имена инструментов, сигнатуры, переменные окружения и точки входа (server:main) полностью сохранены.

Совместимость с дорожной картой

Страна	Статус	Стандарт	Транспорт	Наследует	Переопределяет	Известные пробелы
🇫🇷 FR	✅ Готово	XP Z12-013	Гибрид / PPF hub	`BaseEInvoicingClient`, `BaseLifecycleManager`	`submit_lifecycle_status`, `healthcheck`	Нет
🇮🇹 IT	✅ Готово	FatturaPA v1.6.1	Прямой / SDI	`BaseDocumentGenerator`, `BaseDocumentValidator`, `BaseDocumentParser`, `BasePartyValidator`	все абстрактные методы	`to_invoice_document()` еще не реализован
🇧🇪 BE	✅ Готово	Peppol BIS 3.0	AS4 / Peppol	все базовые классы	`generate()` → UBL 2.1, `validate()` → Schematron EN16931	Нет
🇵🇱 PL	🔄 В процессе	KSeF FA(2)	Прямой API	`BaseDocumentGenerator`, `BaseDocumentValidator`, `BaseLifecycleManager`	Поток сессионной авторизации KSeF	Режим авторизации `MTLS` еще не реализован
🇩🇪 DE	🔄 В процессе	ZUGFeRD / XRechnung	AS4 / Peppol	все базовые классы	`generate()` возвращает байты PDF (base64)	Неоднозначность типа возвращаемого значения `generate()`: `str` против `bytes`
🇪🇸 ES	🔄 В процессе	FACeB2B / FacturaE	Прямой API	все базовые классы	mTLS авторизация	Режим авторизации `MTLS` еще не реализован
🇷🇴 RO	📋 Бэклог	RO-UBL (EN 16931)	Прямой API / клиринг	`BaseDocumentGenerator`, `BaseLifecycleManager`	Поток клиринга ANAF	Нужен вариант `BaseSchematronValidator`
🇬🇷 GR	📋 Бэклог	myDATA XML	Прямой API / отчетность	`BaseEInvoicingClient`, `BaseLifecycleManager`	Поток авторизации + отчетности myDATA	Клиент API myDATA еще не спроектирован
🇳🇱🇸🇪🇩🇰🇳🇴 Северные страны/NL	📋 Бэклог	Peppol BIS 3.0 / UBL	AS4 / Peppol	все базовые классы	`generate()` → UBL 2.1, `validate()` → Schematron	Повторно использует транспортный уровень BE AS4
🇵🇹 PT	📋 Бэклог	CIUS-PT + QR-код	Подпись / прямой	`BaseDocumentGenerator`, `BaseDocumentValidator`	Квалифицированная подпись + внедрение QR	Интеграция квалифицированной подписи не спроектирована

Архитектурные заметки

Интерфейс транспорта

По мере роста количества адаптеров абстракция TransportInterface в ядре предотвратит дублирование в странах, использующих один и тот же транспортный уровень:

Транспорт	Страны
Прямой API (клиринг / отчетность)	FR, RO, GR, HU
AS4 / Сеть Peppol	BE, DE, Северные страны/NL
Гибрид / хаб	FR (двойной путь PPF/PDP)

Германия: 80% повторного использования из FR

Немецкий мандат (действующий с января 2025 года для получения B2B) в значительной степени отдает предпочтение ZUGFeRD/Factur-X — той же модели XML, встроенной в PDF, что и французский профиль Factur-X. Логика генерации и валидации XML из mcp-facture-electronique-fr может быть повторно использована с минимальными изменениями, что делает DE следующим адаптером с наименьшими затратами усилий после BE.

ViDA / DRR (2030)

К июлю 2030 года все национальные системы должны быть приведены в соответствие с требованиями ЕС к цифровой отчетности (Digital Reporting Requirement) для трансграничных транзакций. Использование EN 16931 в качестве внутренней модели данных InvoiceDocument в этом базовом пакете уже обеспечивает готовность проекта к будущим изменениям: адаптеры стран переводят EN 16931 → локальный формат, а не наоборот.

Лицензия

Apache 2.0 — см. LICENSE.

Install Server

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

4dRelease cycle

29Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

einvoice-mcp
Finance App Automation
makririch
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.
Updated 4 months ago (2026-04-13 15:27 UTC)
6
56
2
MIT
mcp-facture-electronique-fr
Payments & Billing Finance
cmendezs
A
license
A
quality
C
maintenance
Model Context Protocol (MCP) server for French Electronic Invoicing (NF XP Z12-013). Provide tools to validate, generate, and explore API specifications for PDP/OD interoperability.
Updated 8 days ago (2026-08-09 07:44 UTC)
34
Apache 2.0
mcp-fattura-elettronica-it
Finance Payments & Billing
cmendezs
A
license
A
quality
A
maintenance
Model Context Protocol (MCP) server for Italian Electronic Invoicing (FatturaPA / SDI). Provide tools to validate, generate, and explore API specifications for Sistema di Interscambio (SDI) interoperability.
Updated 6 days ago (2026-08-11 15:45 UTC)
27
1
Apache 2.0
mcp-einvoicing-be
Finance Payments & Billing
cmendezs
A
license
A
quality
A
maintenance
Model Context Protocol (MCP) server for Belgian Electronic Invoicing (Peppol BIS 3.0 / PINT-BE / Mercurius). Provides tools to validate, generate, and transform UBL 2.1 e-invoices, and look up BCE/KBO enterprise data and Peppol participants.
Updated 8 days ago (2026-08-09 07:44 UTC)
7
Apache 2.0

View all related MCP servers

Related MCP Connectors

fiscal
Brazilian fiscal MCP server - issue NF-e, NFC-e, NFS-e, CT-e, MDF-e and DC-e via SEFAZ.
InvoiceXML
Create, validate, convert & extract compliant e-invoices (UBL, Factur-X, ZUGFeRD, XRechnung)
Second Eyes Agent Workflow Services
Workflow diagnostics, capability routing, and x402 settlement for MCP-compatible agents.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/cmendezs/mcp-einvoicing-core'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

mcp-einvoicing-core

Что предоставляет этот пакет

Установка

Архитектура

Шаблон регистрации плагинов

Совместимость с Claude Desktop / Cursor / Kiro

Совместимость с дорожной картой

Архитектурные заметки

Интерфейс транспорта

Германия: 80% повторного использования из FR

ViDA / DRR (2030)

Лицензия

Maintenance

Resources

Looking for Admin?

Related MCP Servers

einvoice-mcp

mcp-facture-electronique-fr

mcp-fattura-elettronica-it

mcp-einvoicing-be

Related MCP Connectors

Latest Blog Posts

MCP directory API