PNPC-MCP-Tally-Prime

Ein Model Context Protocol (MCP)-Server, der es Claude ermöglicht, über sein integriertes XML/HTTP-Gateway von TallyPrime zu lesen und darauf zu schreiben.

Abgezweigt von vaijaaaaa/Tally-MCP-Server (ISC-lizenziert) für die interne Nutzung von PNPC. Siehe LICENSE für den Hinweis des ursprünglichen Autors.

Wie es funktioniert

Claude Desktop  <--stdio-->   ┐
                               ├─ this MCP server  <--HTTP/XML-->  TallyPrime (localhost:9000)
Remote MCP client <--HTTP-->  ┘

Lokal startet Claude Desktop diesen Server als stdio-Prozess. Remote kann er auch als HTTP-Server laufen. In beiden Fällen werden Tool-Aufrufe in Tallys XML-Anfrageformat übersetzt, an Tallys HTTP-Gateway gesendet und als bereinigtes JSON zurückgegeben. Es gibt auch einen optionalen lokalen SQL-Cache (PGLite) für Ad-hoc-Abfragen, die über die festen Berichtstools hinausgehen.

Voraussetzungen

• Node.js 18+

• TallyPrime installiert, läuft, mit einem geöffneten Unternehmen

• Tallys HTTP-Gateway aktiviert: F1 (Help) > Settings > Connectivity > Client/Server configuration und setzen Sie TallyPrime acts as auf Both oder Server, Port 9000 (Standard).

Einrichtung

npm install
npm run build

Claude Desktop konfigurieren

Option A — Erweiterung (empfohlen): als .dxt paketieren und mit einem Klick installieren. Siehe docs/EXTENSION_PACKAGING.md.

Option B — manuelle Konfiguration: bearbeiten Sie Ihre Claude Desktop-Konfigurationsdatei:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Fügen Sie hinzu:

{
  "mcpServers": {
    "pnpc-tally": {
      "command": "C:\\Users\\Lokesh\\node20\\node.exe",
      "args": ["C:\\Users\\Lokesh\\PNPC-MCP-Tally-Prime\\dist\\index.js"],
      "env": {
        "TALLY_URL": "http://localhost:9000"
      }
    }
  }
}

Starten Sie Claude Desktop neu. Sie sollten ein Hammer/Werkzeug-Symbol sehen, das anzeigt, dass der pnpc-tally-Server verbunden ist.

Verfügbare Tools

Insgesamt 17 Tools — lesen (Konten, Bestand, Gruppen, Belegarten, Kostenstellen, Tagebuch, Kontobelege, Unternehmensinfo, GuV, Bilanz, Summen- und Saldenliste, Bestandszusammenfassung, Forderungen/Verbindlichkeiten), schreiben (Konto erstellen, Gruppe erstellen, Lagerartikel erstellen, Beleg erstellen) und SQL-Cache (sync_to_sql, query_sql). Vollständige Referenz mit Argumenten: docs/TOOLS.md.

Daten verwenden das Format DD-MM-YYYY, entsprechend Tallys Konvention.

Remote ausführen (HTTP)

TALLY_MCP_TOKEN=<secret> npm run start:http

Siehe docs/HTTP_DEPLOYMENT.md.

Dokumentation

• docs/ARCHITECTURE.md — Anfragefluss, Dateiverantwortlichkeiten

• docs/TALLY_XML_GUIDE.md — wie Tallys XML-Gateway funktioniert, Stolperfallen

• docs/TOOLS.md — vollständige Tool-Referenz + wie man ein neues Tool hinzufügt

• docs/SQL_CACHE.md — der PGLite SQL-Cache, Schema, Beispiele

• docs/HTTP_DEPLOYMENT.md — als Remote-HTTP-Server ausführen

• docs/EXTENSION_PACKAGING.md — als .dxt Claude Desktop Extension paketieren

Projektstruktur

src/
  tally.ts        Tally HTTP client: sends XML, handles connection/timeout errors
  clean.ts        Normalizes Tally's raw XML->JSON into predictable JSON
  templates.ts     Renders the Nunjucks XML templates in templates/
  db.ts             PGLite SQL cache: sync_to_sql / query_sql
  tools.ts        MCP tool definitions + XML request builders
  server.ts       Shared MCP Server construction (used by both entry points)
  index.ts        stdio entry point (local Claude Desktop)
  http-server.ts   HTTP entry point (remote clients)
templates/
  *.xml.njk       Nunjucks templates for each Tally XML request shape
manifest.json      Claude Desktop Extension (.dxt) manifest

Umgebungsvariablen

Fehlerbehebung

• "TallyPrime konnte nicht erreicht werden" — Tally läuft nicht, oder das HTTP-Gateway ist nicht auf Port 9000 aktiviert.

• "Tally hat eine leere Antwort zurückgegeben" — Tally läuft, aber es ist kein Unternehmen geöffnet.

• create_ledger / create_voucher schlägt mit Fehlern fehl — überprüfen Sie, ob die übergeordnete Gruppe / Kontonamen genau mit dem übereinstimmen, was in Tally vorhanden ist (Namen sind Groß-/Kleinschreibung beachten und müssen exakt übereinstimmen).

Roadmap / noch nicht unterstützt

• Bearbeiten oder Löschen vorhandener Belege/Konten/Master

• Inventarbelege (Stock Journal, Manufacturing Journal, etc.)

• GST-spezifische Berichte (GSTR-1, GSTR-3B)

• Multi-Company-Unterstützung (aktuell wird immer das geöffnete Unternehmen angesprochen)