india-stack-mcp

インドのエンタープライズシステム向けの本番グレードのMCPサーバー。インドで帳簿管理と税務申告ができるエージェント — まずは、インドの何百万もの中小企業が使う会計システム TallyPrime から始めます。

なぜ

最先端のエージェントはGSTについて推論できますが、Tallyには触れません。最新のAPIもOAuthもSDKもなく、準備不足の者を罰するローカルXMLゲートウェイがあるだけです。このプロジェクトは、欠けていたコネクタ層です。型付きツール、ドライラン優先の書き込み、冪等性、人間の承認フック、改ざん防止の監査証跡を備え、Claude Desktop、Claude Code、Cursor、Codex、または任意のMCPクライアントで動作する標準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がローカルで実行され、ポート9000でXMLサービスが有効になっていること（F1 → 設定 → 接続）。docs/tally-xml-notes.md を参照してください。

Zoho Books では、Books スコープ（ZohoBooks.fullaccess.all またはそれより狭い）を持つセルフクライアント OAuth リフレッシュトークンが必要です。これは Zoho API Console で作成します。認証情報は、環境変数の代わりにファイルベースのボールト（core の 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。書き込み（デフォルトでドライラン）：zoho_create_contact、zoho_create_invoice、zoho_create_item、zoho_create_customer_payment。

GST操作（4） — gst_validate_gstin（mod-36チェックサム、州、PAN/法人種別）、gst_einvoice_build（税分割と丸めを含む正規v1.01ペイロード）、gst_einvoice_generate（プラグ可能なIRPクライアントによるIRN、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