india-stack-mcp

Промышленные MCP-серверы для индийских корпоративных систем. Агенты, которые могут вести бухгалтерию и подавать налоги в Индии — начиная с TallyPrime, бухгалтерской системы, стоящей за миллионами индийских малых и средних предприятий.

Зачем

Передовые агенты могут рассуждать о GST, но не могут прикоснуться к Tally. Нет современного API, нет OAuth, нет SDK — только локальный XML-шлюз, который наказывает неподготовленных. Этот проект — недостающий слой подключения: типизированные инструменты, запись с предварительным просмотром (dry-run), идемпотентность, хуки для одобрения человеком и защищённый от несанкционированного доступа журнал аудита, упакованные в стандартные MCP-серверы, работающие в Claude Desktop, Claude Code, Cursor, Codex или любом MCP-клиенте.

Статус

Быстрый старт

npm install
npm run build

Укажите Claude Desktop / Cursor на собранный сервер (см. 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": "..."
      }
    }
  }
}

Требования на стороне Tally: TallyPrime, запущенный локально с включённой XML-подачей на порту 9000 (F1 → Настройки → Подключение). См. docs/tally-xml-notes.md.

Zoho Books требует self-client OAuth refresh token с областями Books (ZohoBooks.fullaccess.all или уже), созданный в Zoho API Console. Учётные данные также могут храниться в файловом хранилище вместо переменных окружения (CredentialVault в ядре).

Инструменты (27)

Tally (12) — Чтение: 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. Запись: tally_create_ledger, tally_create_voucher (7 типов ваучеров), tally_delete_voucher.

Zoho Books (11) — Чтение: zoho_list_organizations, zoho_list_contacts, zoho_get_contact, zoho_list_invoices, zoho_get_invoice, zoho_list_items, zoho_chart_of_accounts. Запись (по умолчанию dry-run): zoho_create_contact, zoho_create_invoice, zoho_create_item, zoho_create_customer_payment.

GST ops (4) — gst_validate_gstin (контрольная сумма mod-36, штат, PAN/тип организации), gst_einvoice_build (канонический payload v1.01 с разбивкой налогов и округлением), gst_einvoice_generate (IRN через подключаемый IRP-клиент; зашифрованные конверты в стиле NIC: RSA-обёрнутый SEK + AES-256-CBC + HMAC-SHA256), gst_reconcile_2b (классификация совпадений/несовпадений/отсутствующих записей между вашим реестром покупок и GSTR-2B, с количественной оценкой риска ITC).

Каждая запись возвращает точное тело запроса к вышестоящей системе в качестве предварительного просмотра, пока вы не передадите dry_run: false. Повторные попытки с тем же idempotency_key никогда не приводят к двойной отправке.

Модель безопасности

• Запись по умолчанию выполняется в режиме предварительного просмотра; для подтверждения требуется явное согласие.

• Ваучеры проверяются на баланс на стороне клиента перед любым сетевым вызовом.

• Каждый вызов добавляет редактируемую (с удалением конфиденциальных данных) запись аудита с хэш-цепочкой (INDIA_STACK_AUDIT_LOG).

• Деструктивные инструменты могут требовать одобрения человека через подключаемый Approver.

Полное описание архитектуры см. в docs/architecture.md.

HTTP-режим

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

Разработка

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

Лицензия

Apache-2.0