Skip to main content
Glama
Sign In
sef-mcp

sef-mcp

by jvrbnjak89
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

sef-mcp

EN: Local-first MCP server that lets an AI assistant (Claude Desktop, Claude Code, Cursor…) draft and send e-invoices to the Serbian SEF (Sistem elektronskih faktura). Safe by default: demo environment, two-step send with human approval, secrets only via a secret manager. Company-specific rules live in a local profile, not in code.

MCP server koji AI asistentu omogućava da pripremi i pošalje izlaznu e-fakturu na SEF — na tvom računaru, sa tvojim API ključem, bez posrednika.

Zašto još jedan SEF MCP

Hostovani MCP servisi

sef-mcp

Gde ide tvoj API ključ

Kroz tuđi server

Ostaje na tvom računaru

Ko vidi fakture

Treća strana

Samo ti i SEF

Slanje

Jedan poziv

Nacrt → tvoje odobrenje → slanje

Pravila firme (PDV status, kupci, numeracija)

U promptu

U lokalnom profilu, validirano

Podrazumevano okruženje

Različito

demo (bez poreskog efekta)

Related MCP server: serbia-invoice-mcp

Šta ume (v0.1)

Alat

Šta radi

Menja stanje?

sef_check_setup

Okruženje, sigurnosni prekidači, profil

ne

sef_ping

Proverava ključ i vezu sa SEF-om

ne

sef_list_customers

Kupci iz profila

ne

sef_list_vat_exemption_reasons

Zvanične šifre izuzeća (npr. PDV-RS-33)

ne

sef_list_unit_measures

Zvanične jedinice mere (npr. MON, HUR, H87)

ne

sef_draft_invoice

Pravi UBL fakturu lokalno, vraća iznose i approvalCode

samo lokalno

sef_get_draft

Čita nacrt (opciono sa XML-om)

ne

sef_send_invoice

Šalje odobren nacrt na SEF

da

sef_get_invoice / sef_list_invoice_ids

Status i pregled poslatih faktura

ne

sef_cancel_invoice

Otkazuje fakturu u statusu Nacrt / Nova / Greška pri slanju

da

sef_storno_invoice

Stornira fakturu u statusu Poslata / Prihvaćena / Odbijena

da

Brzi početak

git clone <repo> sef-mcp && cd sef-mcp
npm install && npm test
node dist/src/index.js init ~/.config/sef-mcp/profile.json   # pa popuni podatke firme

Zatim prati docs/setup.md: API ključ u 1Password-u (ili drugom secret manageru), povezivanje sa Claude Desktop / Claude Code / Cursor, prvi test na demo okruženju.

Bezbednost ukratko

  • Podrazumevano SEF_ENV=demo. Produkcija traži dva prekidača: SEF_ENV=prod i SEF_MCP_ALLOW_PROD_WRITE=true.

  • Slanje zahteva draftId + approvalCode (prvih 8 znakova SHA-256 XML-a) — šalje se tačno verzija koju si video.

  • Ključ se nikad ne loguje, ne vraća iz alata i ne čuva na disku. Prihvata se samo iz okruženja.

  • Klijent komunicira isključivo sa efaktura.mfin.gov.rs / demoefaktura.mfin.gov.rs.

  • Prilozi samo iz jednog dozvoljenog foldera, samo PDF, sa ograničenjem veličine.

  • Lokalni audit log (audit.jsonl) svakog nacrta, slanja i otkazivanja.

Detalji: SECURITY.md i docs/technical-spec.md.

Status

v0.1 — rana faza. Usklađeno sa SEF API specifikacijom od 31.07.2026 (SEF 3.14) i ITU od 01.10.2026. UBL generator reprodukuje strukturu fakture koju je SEF prihvatio u produkciji (golden test). Pre produkcije još: test na demo okruženju (executeValidation=true). Vidi docs/roadmap.md.

Dokumentacija

Odricanje odgovornosti

Ovo nije zvaničan alat Ministarstva finansija. Odgovornost za sadržaj i poresku ispravnost faktura ostaje na izdavaocu. Poreske kategorije i šifre izuzeća potvrdi sa svojim knjigovođom.

Licenca

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Poland Invoice MCP

    junter1989k-ai
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to issue Poland structured e-invoices (faktura ustrukturyzowana) through KSeF 2.0, handling FA(3) XML building, encrypted session flow, and KSeF number retrieval.
    MIT

  • serbia-invoice-mcp

    junter1989k-ai
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to issue, query, and cancel Serbia SEF eFaktura electronic invoices (UBL 2.1 SRB-CIUS) into the national Ministry of Finance system, using the merchant's own API key.
    MIT

  • Scribo MCP Server

    causa-prima-ai
    F
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to create and manage e-invoices through natural language, supporting EU compliance formats like ZUGFeRD and XRechnung, as well as US plain PDF invoices.
    7
    -

  • Kontor MCP

    DashankaNadeeshanDeSilva
    A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI assistants to locally parse, validate, audit, explain, generate, and convert XRechnung and ZUGFeRD/Factur-X e-invoices using official rule sets, fully offline with no API keys required.
    Apache 2.0