PNPC-MCP-Tally-Prime

Un servidor de Model Context Protocol (MCP) que permite a Claude leer y escribir en TallyPrime a través de su puerta de enlace XML/HTTP integrada.

Bifurcado de vaijaaaaa/Tally-MCP-Server (con licencia ISC) para uso interno de PNPC. Consulta LICENSE para el aviso del autor original.

Cómo funciona

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

Localmente, Claude Desktop inicia este servidor como un proceso stdio. De forma remota, también puede ejecutarse como un servidor HTTP. En cualquier caso, las llamadas a herramientas se traducen al formato de solicitud XML de Tally, se envían a la puerta de enlace HTTP de Tally y se devuelven como JSON depurado. También hay una caché SQL local opcional (PGLite) para consultas ad hoc más allá de las herramientas de informes fijas.

Requisitos previos

• Node.js 18+

• TallyPrime instalado, en ejecución, con una empresa abierta

• La puerta de enlace HTTP de Tally habilitada: F1 (Help) > Settings > Connectivity > Client/Server configuration y establecer TallyPrime acts as a Both o Server, puerto 9000 (predeterminado).

Configuración

npm install
npm run build

Configurar Claude Desktop

Opción A — Extensión (recomendada): empaquetar como .dxt e instalar con un clic. Consulta docs/EXTENSION_PACKAGING.md.

Opción B — configuración manual: edita tu archivo de configuración de Claude Desktop:

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

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

Añade:

{
  "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"
      }
    }
  }
}

Reinicia Claude Desktop. Deberías ver un icono de martillo/herramientas que indica que el servidor pnpc-tally está conectado.

Herramientas disponibles

17 herramientas en total — lectura (ledgers, stock, grupos, tipos de comprobante, centros de costo, libro diario, comprobantes de ledger, información de empresa, P&L, balance de situación, balance de comprobación, resumen de stock, cuentas por cobrar/pagar), escritura (crear ledger, grupo, artículo de stock, comprobante) y caché SQL (sync_to_sql, query_sql). Referencia completa con argumentos: docs/TOOLS.md.

Las fechas usan el formato DD-MM-YYYY, coincidiendo con la convención de Tally.

Ejecución remota (HTTP)

TALLY_MCP_TOKEN=<secret> npm run start:http

Consulta docs/HTTP_DEPLOYMENT.md.

Documentación

• docs/ARCHITECTURE.md — flujo de solicitudes, responsabilidades de archivos

• docs/TALLY_XML_GUIDE.md — cómo funciona la puerta de enlace XML de Tally, problemas comunes

• docs/TOOLS.md — referencia completa de herramientas + cómo añadir una nueva herramienta

• docs/SQL_CACHE.md — la caché SQL PGLite, esquema, ejemplos

• docs/HTTP_DEPLOYMENT.md — ejecución como servidor HTTP remoto

• docs/EXTENSION_PACKAGING.md — empaquetado como extensión .dxt de Claude Desktop

Estructura del proyecto

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

Variables de entorno

Solución de problemas

• "No se pudo alcanzar TallyPrime" — Tally no está en ejecución, o la puerta de enlace HTTP no está habilitada en el puerto 9000.

• "Tally devolvió una respuesta vacía" — Tally está en ejecución pero no hay ninguna empresa abierta.

• create_ledger / create_voucher falla con errores — verifica que los nombres del grupo principal / ledger coincidan exactamente con lo que existe en Tally (los nombres distinguen entre mayúsculas y minúsculas y deben coincidir exactamente).

Hoja de ruta / aún no compatible

• Editar o eliminar comprobantes/ledgers/maestros existentes

• Comprobantes de inventario (Stock Journal, Manufacturing Journal, etc.)

• Informes específicos de GST (GSTR-1, GSTR-3B)

• Soporte multiempresa (actualmente siempre apunta a la empresa que esté abierta)