india-stack-mcp

Servidores MCP de grado de producción para sistemas empresariales indios. Agentes que pueden llevar la contabilidad y presentar impuestos en la India, comenzando con TallyPrime, el sistema de contabilidad detrás de millones de PYME indias.

Por qué

Los agentes de frontera pueden razonar sobre el GST, pero no pueden tocar Tally. No hay API moderna, ni OAuth, ni SDK — solo una pasarela XML local que castiga a los desprevenidos. Este proyecto es la capa de conexión que faltaba: herramientas tipadas, escrituras con previsualización primero, idempotencia, enganches de aprobación humana y un registro de auditoría a prueba de manipulaciones, empaquetado como servidores MCP estándar que funcionan en Claude Desktop, Claude Code, Cursor, Codex o cualquier cliente MCP.

Estado

Inicio rápido

npm install
npm run build

Apunte Claude Desktop / Cursor al servidor compilado (consulte 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": "..."
      }
    }
  }
}

Requisitos en el lado de Tally: TallyPrime ejecutándose localmente con el servicio XML habilitado en el puerto 9000 (F1 → Configuración → Conectividad). Consulte docs/tally-xml-notes.md.

Zoho Books necesita un token de actualización OAuth de cliente propio con alcances de Books (ZohoBooks.fullaccess.all o más restringido), creado en la Consola de API de Zoho. Las credenciales también pueden residir en un almacén basado en archivos en lugar de variables de entorno (CredentialVault en el núcleo).

Herramientas (27)

Tally (12) — Lecturas: 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. Escrituras: tally_create_ledger, tally_create_voucher (7 tipos de comprobante), tally_delete_voucher.

Zoho Books (11) — Lecturas: zoho_list_organizations, zoho_list_contacts, zoho_get_contact, zoho_list_invoices, zoho_get_invoice, zoho_list_items, zoho_chart_of_accounts. Escrituras (previsualización por defecto): zoho_create_contact, zoho_create_invoice, zoho_create_item, zoho_create_customer_payment.

Operaciones GST (4) — gst_validate_gstin (suma de verificación mod-36, estado, tipo de PAN/entidad), gst_einvoice_build (carga útil canónica v1.01 con desgloses de impuestos + redondeo), gst_einvoice_generate (IRN mediante cliente IRP conectable; sobres cifrados estilo NIC: SEK envuelto con RSA + AES-256-CBC + HMAC-SHA256), gst_reconcile_2b (clasificación de coincidencias/discrepancias/faltantes entre su registro de compras y GSTR-2B, con cuantificación del ITC en riesgo).

Cada escritura devuelve el cuerpo de solicitud ascendente exacto como vista previa hasta que pase dry_run: false. Los reintentos con la misma idempotency_key nunca duplican la publicación.

Modelo de seguridad

• Las escrituras se previsualizan por defecto; confirmar requiere una aceptación explícita.

• Los comprobantes se verifican en cuanto a saldo en el lado del cliente antes de cualquier llamada de red.

• Cada invocación añade un registro de auditoría redactado y encadenado por hash (INDIA_STACK_AUDIT_LOG).

• Las herramientas destructivas pueden requerir aprobación humana mediante un Approver conectable.

Consulte docs/architecture.md para el diseño completo.

Modo HTTP

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

Desarrollo

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

Licencia

Apache-2.0