Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

csv2zugferd

✓ zugferd-tools.de

von rillsoftVersion 1.3.1i★ 3 (Sterne gehören zu einem anderen Repo)iLäuft auf deinem ComputerOffizielle Website ↗
Name in der Registryde.zugferd-tools/csv2zugferd

So installierst du es

What it does

csv2zugferd setup assistant: drafts and checks the CSV to ZUGFeRD/Factur-X mapping, local via stdio

  • Connects Läuft auf deinem Computer
  • Account or key No key needed
  • Category Datenbanken & Datensätze

Zusammen nutzen mit

Skills, die der KI diese Art Arbeit beibringen; sie funktionieren zusammen mit diesem

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

von google-research★ 35.6381 Skills

Skill · Anleitung

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

von BigBodyCobain★ 11.6051 Skills

Skill · Anleitung

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

von gosom★ 8.2361 Skills

Skill · Anleitung

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit0/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch0/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert12/100

Qualität: 2/3 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte csv2zugferd. Folge https://mcp.popnx.com/i/de-zugferd-tools-csv2zugferd.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

2/3 Prüfungen bestanden · Läuft auf deinem Computer · ✓ Befehle geprüft am 13. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude, aber erst etwas vorbereiten

Kein Schlüssel, nichts zu installieren · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

Von der KI installieren lassen

Kopiere diese Nachricht in einen Claude-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server csv2zugferd für Claude auf diesem Rechner, in dieser Reihenfolge: 1) 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "csv2zugferd": { "command": "dnx", "args": [ "csv2zugferd", "--yes", "mcp" ] } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von csv2zugferd wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Einstellungsdatei der Claude-Desktop-App öffnen

    SettingsDeveloperEdit Config

  2. Diese Einstellungen einfügen und speichern

    {
      "mcpServers": {
        "csv2zugferd": {
          "command": "dnx",
          "args": [
            "csv2zugferd",
            "--yes",
            "mcp"
          ]
        }
      }
    }
  3. Claude beenden und neu öffnen

  4. Ausprobieren

    Nutze csv2zugferd und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es csv2zugferd nutzt, oder ein Werkzeug von csv2zugferd in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann csv2zugferd noch nicht verbinden

csv2zugferd läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen

Das kannst du stattdessen tun

A · Eine App nutzen, die csv2zugferd verbinden kann

  • Kein Schlüssel, nichts zu installieren · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
  • Kein Schlüssel, nichts zu installieren
  • Kein Schlüssel, nichts zu installieren
  • Kein Schlüssel, nichts zu installieren

B · Andere in Datenbanken & Datensätze, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Klappt mit Claude Code, aber erst etwas vorbereiten

Kein Schlüssel, nichts zu installieren

Von der KI installieren lassen

Kopiere diese Nachricht in einen Claude Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server csv2zugferd für Claude Code auf diesem Rechner, in dieser Reihenfolge: 1) 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): claude mcp add --scope user csv2zugferd -- dnx csv2zugferd --yes mcp 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von csv2zugferd wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  2. Diesen Befehl einfügen und Enter drücken

    claude mcp add --scope user csv2zugferd -- dnx csv2zugferd --yes mcp
  3. /mcp in Claude Code eingeben

    csv2zugferd sollte in der Liste als verbunden erscheinen

  4. Ausprobieren

    Nutze csv2zugferd und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es csv2zugferd nutzt, oder ein Werkzeug von csv2zugferd in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor, aber erst etwas vorbereiten

Kein Schlüssel, nichts zu installieren

Von der KI installieren lassen

Kopiere diese Nachricht in einen Cursor-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server csv2zugferd für Cursor auf diesem Rechner, in dieser Reihenfolge: 1) 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "csv2zugferd": { "command": "dnx", "args": [ "csv2zugferd", "--yes", "mcp" ] } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von csv2zugferd wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in Cursor im Agent-Modus öffnen

  3. Ausprobieren

    Nutze csv2zugferd und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es csv2zugferd nutzt, oder ein Werkzeug von csv2zugferd in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code, aber erst etwas vorbereiten

Kein Schlüssel, nichts zu installieren

Von der KI installieren lassen

Kopiere diese Nachricht in einen VS Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server csv2zugferd für VS Code auf diesem Rechner, in dieser Reihenfolge: 1) 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "servers": { "csv2zugferd": { "type": "stdio", "command": "dnx", "args": [ "csv2zugferd", "--yes", "mcp" ] } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von csv2zugferd wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in VS Code im Agent-Modus öffnen

  3. Ausprobieren

    Nutze csv2zugferd und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es csv2zugferd nutzt, oder ein Werkzeug von csv2zugferd in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die csv2zugferd nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user csv2zugferd -- dnx csv2zugferd --yes mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "csv2zugferd": {
      "command": "dnx",
      "args": [
        "csv2zugferd",
        "--yes",
        "mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "csv2zugferd": {
      "command": "dnx",
      "args": [
        "csv2zugferd",
        "--yes",
        "mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "csv2zugferd": {
      "type": "stdio",
      "command": "dnx",
      "args": [
        "csv2zugferd",
        "--yes",
        "mcp"
      ]
    }
  }
}

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

GitHub-Sternei
3 (Sterne gehören zu einem anderen Repo)
Dieser Eintrag verweist auf das Repo einer anderen Person, daher zählen die Sterne nicht in Ranglisten
Downloads pro Wochei
Nicht auf npm/PyPI
Bestätigte Domain
✓ zugferd-tools.de
Lizenzi
Apache-2.0
Verbindung
Läuft auf deinem Computer
Neueste Versioni
1.3.1
In der Registry veröffentlichti
9. Nov. 2026
Code zuletzt geänderti
9. Nov. 2026
Entwickler
rillsoft
Pakete
nuget: csv2zugferd
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Laufen auf deinem Computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026

  • ! Vorsicht

    Entwickler passt zum Repo

    Der Herausgeber (zugferd-tools.de) ist nicht der Repo-Inhaber (rillsoft); vielleicht hat jemand anderes ihn eingetragen

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 10 Tagen

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt Apache-2.0

  • – Nicht zutreffend

    Endpunkt antwortet

    Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Veröffentlichte Schwachstellen (OSV.dev)

Nicht geprüft: nur npm- und PyPI-Pakete mit Version lassen sich prüfen

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/de-zugferd-tools-csv2zugferd.svg)](https://mcp.popnx.com/en/servers/de-zugferd-tools-csv2zugferd)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Datenbanken & Datensätzei

  • Mehr Sterne als 0 % der anderen 1237 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 83 % der anderen 1237 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 50 % der anderen 1237 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist csv2zugferd sicher?

Er hat 2 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 10 Tagen geändert, und die neueste Version (1.3.1) kam vor 10 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du .NET auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: QueryWeaver, Supabase, Neon, DBCode, Keboola MCP

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

QueryWeaver

An MCP server for Text2SQL: transforms natural language into SQL using graph schema understanding.

von FalkorDBWachsend★ 1096Aktualisiert vor 14 Monaten

Läuft auf deinem Computer✓ falkordb.com

Supabase

MCP server for interacting with the Supabase platform

von supabaseWeit verbreitet↓ 245.530/Wo.★ 3018 Sterne des ganzen ReposAktualisiert gestern

Computer oder Cloud✓ vom Dienst · supabase.com

Neon

Official Neon MCP server for managing Neon projects and Lakebase Postgres databases.

von neondatabaseWachsend★ 666Aktualisiert vor 13 Tagen

Läuft in der Cloud✓ vom Dienst · neon.com

DBCode

Query and explore 100+ databases through your DBCode connections.

von dbcodeioAm Anfang↓ 118/Wo.★ 368 Sterne des ganzen ReposAktualisiert vor 2 Monaten

Läuft auf deinem Computer✓ vom Dienst · dbcode.io

Keboola MCP

Connect your AI assistants to Keboola and expose your data, transformations, SQL queries, ...

von keboolaWachsend↓ 1421/Wo.★ 84Aktualisiert vor 3 Tagen

Computer oder Cloud✓ vom Dienst · keboola.com
Im Vergleich mit ähnlichen
Dieser
csv2zugferd
QueryWeaverSupabaseNeonDBCodeKeboola MCP
Läuft woWird auf deinem Rechner installiertWird auf deinem Rechner installiertIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine InstallationWird auf deinem Rechner installiertIn der Cloud oder auf deinem Rechner
Braucht SchlüsselNeinNeinJaNeinNeinNein
Mit + in Claude hinzufügenNeinNeinJaJaNeinNein
Basisprüfungen2/33/35/55/52/35/5
LizenzApache-2.0AGPL-3.0Apache-2.0MITNOASSERTIONMIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

csv2zugferd Dokumentation

Website: zugferd-tools.de

csv2zugferd ist ein .NET-CLI-Tool, das Rechnungsdaten aus CSV-Dateien liest und daraus ZUGFeRD-konforme XML-Dateien oder PDF-Dateien mit eingebettetem ZUGFeRD-XML erzeugt. Die Struktur der CSV-Datei und das Mapping auf ZUGFeRD-Felder werden über eine YAML-Konfiguration gesteuert.

Demo-Paket

Das Demo-Paket ist der schnellste Einstieg. Es enthält eine fertige Windows-Exe, zwei Beispiel-Rechnungen und eine vollständige YAML-Konfiguration.

Download: GitHub Releases → Demo-ZIP

DateiBeschreibung
csv2zugferd-win-x64.exeWindows-64-bit-Exe, self-contained (kein .NET nötig)
config_demo.ymlYAML-Konfiguration für die Demo-CSV-Struktur
demo-2026-0001.csvBeispiel-Rechnung 1 – Softwarelizenzen mit Rabatt
demo-2026-0001.pdfPDF-Vorlage zu Rechnung 1
demo-2026-0002.csvBeispiel-Rechnung 2 – Lizenzen, Service und Schulung
demo-2026-0002.pdfPDF-Vorlage zu Rechnung 2
create-zugferd-demo.cmdStartskript – per Doppelklick oder CMD ausführen

Schnellstart:

:: 1. ZIP entpacken, dann:

create-zugferd-demo.cmd :: Ergebnis: output\DEMO-2026-0001.pdf und output\DEMO-2026-0002.pdf

Die erzeugten Dateien sind valide ZUGFeRD-2.3-Rechnungen (Profil Extended) und können mit dem Mustang-Validator geprüft werden.

Detaillierte Erklärung der config_demo.yml: zugferd-tools.de/docs/schnellstart/

Eingaben und Ausgaben

TypFormatBeschreibung
CSV-Datei.csvRechnungsdaten mit Kopf-, Käufer-, Verkäufer-, Positions- und Summenfeldern
PDF-Vorlage.pdfBestehende Rechnungs-PDF, in die das XML eingebettet wird
Konfiguration.ymlYAML-Datei mit CSV-Einstellungen und Mapping-Regeln
XML-Ausgabe.xmlZUGFeRD XML nach konfiguriertem Profil
PDF-Ausgabe.pdfZUGFeRD PDF mit eingebettetem XML

CLI-Nutzung

dotnet run --project .\csv2zugferd\csv2zugferd.csproj -- --csv .\test\0002486.csv --pdf .\test\2483.pdf --config .\test\config_datasrc.yml --output .\test\output
OptionKurzPflichtBeschreibung
--csv-cJaPfad zur CSV-Datei
--pdf-pJaPfad zur PDF-Vorlage
--config-gJaPfad zur YAML-Konfiguration
--output-oNeinAusgabeverzeichnis, Standard ist das aktuelle Verzeichnis
--xml-onlyNeinNur XML erzeugen, kein PDF
--verbose-vNeinDebug-Ausgabe aktivieren

Die Ausgabedateien werden anhand der Rechnungsnummer benannt, zum Beispiel 0002483.xml und 0002483.pdf.

MCP-Server (Einrichtungsassistent)

Seit Version 1.3.0 stellt csv2zugferd mcp das Tool als MCP-Server (Model Context Protocol) über stdio bereit. Zweck ist die Einrichtung: Ein KI-Assistent in Claude Desktop, Claude Code oder VS Code liest den Kopf einer CSV-Datei, entwirft die YAML-Konfiguration, prüft sie im Probelauf gegen den echten Mapping-Code und speichert sie als Datei. Der Produktivlauf bleibt bei der CLI: lokal, deterministisch, ohne Modell und ohne Cloud-Upload durch csv2zugferd. Die gespeicherte Konfiguration gilt für alle weiteren Rechnungen derselben CSV-Struktur.

Vorbereitung: Für die Einrichtung mit einem KI-Assistenten anonymisierte Beispieldaten verwenden. Die Werkzeuge liefern Zellwerte nur auf Anforderung (sampleRows, includeLineItems, includeParties).

Start und Client-Konfiguration

Der Server wird vom MCP-Client gestartet und liest JSON-RPC von stdin; stdout trägt ausschließlich JSON-RPC, Warnungen gehen zusätzlich nach stderr. Die Logdatei zugferd-*.log liegt nicht im Arbeitsverzeichnis (das bestimmt der Client), sondern unter csv2zugferd\logs im lokalen Anwendungsdatenordner (Windows %LOCALAPPDATA%\csv2zugferd\logs, Linux und macOS ~/.local/share/csv2zugferd/logs); die Umgebungsvariable CSV2ZUGFERD_LOG_DIR setzt ein anderes Verzeichnis. --verbose schaltet die Logdatei auf Debug.

Zwei Wege zum Start: die Windows-Exe aus dem GitHub-Release (csv2zugferd.exe mcp, kein .NET nötig) oder das .NET-Tool-Paket csv2zugferd von NuGet, das MCP-Clients mit dnx csv2zugferd@1.3.1 mcp starten (benötigt das .NET-10-SDK; läuft unter Windows, Linux und macOS). Mit dem Release 1.3.1 erscheint der Server in der Official MCP Registry unter dem Namen de.zugferd-tools/csv2zugferd.

Claude Desktop (claude_desktop_config.json):

{

"mcpServers": { "csv2zugferd": { "command": "C:\\Tools\\csv2zugferd.exe", "args": ["mcp"] } } }

Claude Desktop mit dem NuGet-Paket statt der Exe:

{

"mcpServers": { "csv2zugferd": { "command": "dnx", "args": ["csv2zugferd@1.3.1", "mcp"] } } }

Claude Code:

claude mcp add csv2zugferd -- C:\Tools\csv2zugferd.exe mcp

oder mit dem NuGet-Paket:

claude mcp add csv2zugferd -- dnx csv2zugferd@1.3.1 mcp

VS Code (.vscode/mcp.json):

{

"servers": { "csv2zugferd": { "type": "stdio", "command": "C:\\Tools\\csv2zugferd.exe", "args": ["mcp"] } } }

Docker

Für Linux-Umgebungen und Kataloge, die den Server selbst bauen, liegt ein Dockerfile im Repository. Das Image ist framework-abhängig auf mcr.microsoft.com/dotnet/runtime:10.0-noble-chiseled-extra (rund 207 MB, ohne Shell) und läuft ohne Root-Rechte:

docker build -t csv2zugferd .

docker run -i --rm -v "/pfad/zu/rechnungen:/data" csv2zugferd

Der Container startet csv2zugferd mcp und spricht JSON-RPC über stdin und stdout. Die Werkzeuge sehen nur den eingehängten Ordner /data (Arbeitsverzeichnis im Container); Pfade in Werkzeugaufrufen lauten entsprechend /data/ . Die Logdatei bleibt im Container (/tmp/csv2zugferd/logs). Dateien, die der Container unter /data anlegt (csv2zugferd_config_file_create, CLI-Ausgaben), gehören auf Linux-Hosts dem Benutzer mit der ID 1654 (app im Image). Mit Argumenten hinter dem Imagenamen läuft statt des Servers die CLI, zum Beispiel docker run --rm -v "/pfad:/data" csv2zugferd --csv /data/rechnung.csv --pdf /data/vorlage.pdf --config /data/config.yml --output /data/out.

Claude Desktop mit dem Container:

{

"mcpServers": { "csv2zugferd": { "command": "docker", "args": ["run", "-i", "--rm", "-v", "C:\\Rechnungen:/data", "csv2zugferd"] } } }

Werkzeuge
WerkzeugZweckWirkung
csv2zugferd_csv_header_getSpaltennamen und Zeilenzahl einer CSV lesen, optional bis zu 3 Beispielzeilen (sampleRows)lesend
csv2zugferd_config_schema_getVollständige Konfigurationsreferenz: JSON-Schema aller YAML-Schlüssel mit Beschreibung, Typ, Default und zulässigen Werten plus Semantik je Schlüssel (Wirkung, Modusabhängigkeit, Auflösungsreihenfolge, Rückfall). section liefert einen Teilbaum, z. B. mapping.lineItemslesend
csv2zugferd_config_getKonfiguration (Pfad oder YAML-Text) strukturell prüfen: effektive Einstellungen, gemappte Felder mit Quellen, unbekannte Schlüssel, unzulässige Werte mit Rückfall, ignorierte oder fehlende Abschnitte; mit csvPath Spaltenabgleich (fehlende und ungenutzte Spalten)lesend
csv2zugferd_invoice_getProbelauf mit dem echten Mapping ohne Ausgabedatei: Rechnungsnummer, Typ, Summen, Steueraufschlüsselung, Warnungen mit Code und Pfad, XML-Größe; optional Positionen, Parteien und PDF-Probelauf in eine temporäre Datei (pdfTemplatePath)lesend
csv2zugferd_config_file_createGeprüfte YAML als Datei speichern (UTF-8 ohne BOM); vorhandene Datei nur mit overwrite: true; liefert den CLI-Befehl für den Produktivlaufschreibend

Die Werkzeuge nutzen denselben Code wie die CLI. csv2zugferd_config_schema_get ersetzt das Lesen dieser README: Alle Konfigurationsmöglichkeiten sind allein über die Werkzeuge abrufbar und prüfbar.

Ressourcen (resources/list): csv2zugferd://docs/config-reference (diese README), csv2zugferd://examples/config-rows und csv2zugferd://examples/config-columns-suffix (Beispielkonfigurationen aus testdata/).

Ablauf der Inbetriebnahme
  1. CSV-Struktur erfassen: csv2zugferd_csv_header_get mit dem Pfad der (anonymisierten) CSV, bei Bedarf sampleRows: 2.
  2. Mapping erarbeiten: csv2zugferd_config_schema_get liefert Schlüssel, Werte und Wirkung; der Assistent entwirft die YAML.
  3. Prüfen und korrigieren: csv2zugferd_config_get mit configYaml und csvPath meldet Tippfehler (unknownKeys), unzulässige Werte (invalidValues) und fehlende Spalten (columnsMissing); csv2zugferd_invoice_get zeigt Summen, Steuergruppen und Warnungen des echten Mappings. Wiederholen, bis das Ergebnis stimmt.
  4. Speichern: csv2zugferd_config_file_create schreibt die YAML und gibt den CLI-Befehl zurück.
  5. Produktivlauf: Den Befehl mit PDF-Vorlage und Ausgabeverzeichnis ausführen, z. B. csv2zugferd --csv rechnung.csv --pdf vorlage.pdf --config config.yml --output out. Dafür ist weder ein Modell noch ein laufender MCP-Server nötig.
Antworten, Fehler und Grenzen
  • Erfolgreiche Antworten kommen als structuredContent und als inhaltsgleicher JSON-Text; jedes Werkzeug veröffentlicht ein outputSchema, gegen das die Antwort vor dem Senden geprüft wird.
  • Warnungen sind Objekte {code, path, message} mit stabilem englischem Code (z. B. invalid_date, config_field_ignored, invalid_iban_checksum), vollständigem Konfigurationspfad und deutschem Text.
  • Fachliche Ablehnungen sind Tool-Ergebnisse mit isError: true; die erste Textzeile ist der Code (z. B. csv_file_not_found, config_invalid_yaml, file_exists), _meta.errorCode trägt ihn zusätzlich. Unbekannte Werkzeuge und Schemaverletzungen sind JSON-RPC-Fehler -32602 mit Feldpfad.
  • Lesende Werkzeuge liefern keine Antwort über 900 000 Byte; darüber kommt response_too_large mit den Eingrenzungsargumenten des Werkzeugs (sampleRows: 0, includeLineItems: false, section).

YAML-Grundstruktur

csv:

separator: "," encoding: "UTF-8" hasHeader: true decimalSeparator: "." dateFormat: "dd.MM.yyyy"

zugferd: version: "2.3" profile: "Extended" format: "CII"

mapping: invoice: {} buyer: {} seller: {} delivery: {} orderReference: {} lineItems: {} totals: {} paymentTerms: {} paymentMeans: {}

Jedes Mapping-Feld kann entweder einen CSV-Spaltennamen oder einen festen Wert verwenden:

invoiceNumber:

column: "INVOICE_NO"

currency: value: "EUR"

value ist sinnvoll für Stammdaten oder Standards, die nicht in jeder CSV wiederholt werden sollen. column liest den Wert aus der CSV-Zeile.

Zusätzlich kann ein Mapping-Feld einen Fallback und Regex-Regeln definieren:

unitCode:

default: "C62" rules:

  • when: column: "PRODUCT_CODE" regex: "^002" value: "ANN"
  • when: column: "PRODUCT_CODE" regex: "^003" value: "DAY"
  • when: column: "PRODUCT_NAME" regex: "(?i)vor-ort-schulung|schulung" value: "DAY"

Die Reihenfolge ist: value, column, rules, default. Im columns-Modus werden Regelspalten positionsbezogen aufgelöst, also z. B. PRODUCT_CODE_0, PRODUCT_CODE_1 usw.

Feste Verkäuferdaten

Verkäuferdaten können vollständig in der YAML-Konfiguration festgelegt werden. Das ist der empfohlene Weg, wenn alle Rechnungen vom gleichen Absender erzeugt werden.

seller:

name: value: "Muster Lieferant GmbH" id: value: "1234567890" postalCode: value: "80333" city: value: "Muenchen" street: value: "Lieferantenstrasse 20" cou

Nur der Anfang wird gezeigt; den Rest findest du im Repo