india-stack-mcp

Produktionsreife MCP-Server für indische Unternehmenssysteme. Agenten, die Bücher führen und Steuern in Indien einreichen können – beginnend mit TallyPrime, dem Buchhaltungssystem hinter Millionen indischer KMU.

Warum

Frontier-Agenten können über GST nachdenken, aber sie können Tally nicht anfassen. Es gibt keine moderne API, kein OAuth, kein SDK – nur ein lokales XML-Gateway, das die Unvorbereiteten bestraft. Dieses Projekt ist die fehlende Verbindungsschicht: typisierte Tools, Dry-Run-zuerst-Schreibvorgänge, Idempotenz, menschliche Genehmigungshooks und eine manipulationssichere Prüfspur, verpackt als standardmäßige MCP-Server, die in Claude Desktop, Claude Code, Cursor, Codex oder jedem MCP-Client funktionieren.

Status

Schnellstart

npm install
npm run build

Richten Sie Claude Desktop / Cursor auf den gebauten Server (siehe examples/claude_desktop_config.json):

{
  "mcpServers": {
    "tally": {
      "command": "node",
      "args": ["<abs-path>/packages/connector-tally/bin/tally-mcp.js"],
      "env": {
        "TALLY_URL": "http://localhost:9000",
        "TALLY_COMPANY": "Your Company Pvt Ltd"
      }
    },
    "zoho": {
      "command": "node",
      "args": ["<abs-path>/packages/connector-zoho/bin/zoho-mcp.js"],
      "env": {
        "ZOHO_CLIENT_ID": "...",
        "ZOHO_CLIENT_SECRET": "...",
        "ZOHO_REFRESH_TOKEN": "...",
        "ZOHO_DC": "in",
        "ZOHO_ORGANIZATION_ID": "..."
      }
    }
  }
}

Anforderungen auf der Tally-Seite: TallyPrime läuft lokal mit aktiviertem XML-Dienst auf Port 9000 (F1 → Einstellungen → Konnektivität). Siehe docs/tally-xml-notes.md.

Zoho Books benötigt ein Self-Client-OAuth-Refresh-Token mit Books-Berechtigungen (ZohoBooks.fullaccess.all oder enger), das in der Zoho-API-Konsole erstellt wird. Anmeldedaten können auch in einem dateibasierten Tresor statt in Umgebungsvariablen gespeichert werden (CredentialVault im Kern).

Tools (27)

Tally (12) — Lesevorgänge: tally_list_companies, tally_get_company, tally_search_ledgers, tally_get_ledger, tally_day_book, tally_trial_balance, tally_ledger_balances, tally_list_voucher_types, tally_find_vouchers. Schreibvorgänge: tally_create_ledger, tally_create_voucher (7 Belegtypen), tally_delete_voucher.

Zoho Books (11) — Lesevorgänge: zoho_list_organizations, zoho_list_contacts, zoho_get_contact, zoho_list_invoices, zoho_get_invoice, zoho_list_items, zoho_chart_of_accounts. Schreibvorgänge (standardmäßig Dry-Run): zoho_create_contact, zoho_create_invoice, zoho_create_item, zoho_create_customer_payment.

GST-Operationen (4) — gst_validate_gstin (Mod-36-Prüfsumme, Bundesstaat, PAN/Entitätstyp), gst_einvoice_build (kanonische v1.01-Nutzlast mit Steueraufteilungen + Rundung), gst_einvoice_generate (IRN über pluggable IRP-Client; NIC-Stil-verschlüsselte Umschläge: RSA-verpacktes SEK + AES-256-CBC + HMAC-SHA256), gst_reconcile_2b (Klassifizierung von übereinstimmend/nicht übereinstimmend/fehlend über Ihr Einkaufsregister vs. GSTR-2B, mit Quantifizierung des ITC-Risikos).

Jeder Schreibvorgang gibt den genauen Upstream-Anforderungstext als Vorschau zurück, bis Sie dry_run: false übergeben. Wiederholungen mit demselben idempotency_key führen nie zu doppelten Einträgen.

Sicherheitsmodell

• Schreibvorgänge sind standardmäßig Vorschau; das Committen erfordert explizites Opt-in.

• Belege werden vor jedem Netzwerkaufruf clientseitig auf Saldo geprüft.

• Jeder Aufruf fügt einen redigierten, hash-verketteten Prüfdatensatz hinzu (INDIA_STACK_AUDIT_LOG).

• Destruktive Tools können über einen pluggable Approver eine menschliche Genehmigung erfordern.

Siehe docs/architecture.md für das vollständige Design.

HTTP-Modus

npm run start -w @india-stack/demo-host   # POST http://localhost:8787/mcp/tally

Entwicklung

npm run test        # unit + golden-file tests (no Tally needed)
TALLY_LIVE=1 npm run test:live   # hits a real local TallyPrime
npm run lint && npm run typecheck && npm test

Lizenz

Apache-2.0