india-stack-mcp

인도 기업 시스템을 위한 프로덕션급 MCP 서버. 인도에서 장부를 작성하고 세금을 신고할 수 있는 에이전트 — 수백만 인도 중소기업의 기반이 되는 회계 시스템인 TallyPrime부터 시작합니다.

왜 필요한가

최첨단 에이전트는 GST에 대해 추론할 수 있지만 Tally를 직접 다룰 수는 없습니다. 현대적인 API도, OAuth도, SDK도 없습니다 — 준비되지 않은 자를 벌하는 로컬 XML 게이트웨이만 있을 뿐입니다. 이 프로젝트는 누락된 커넥터 계층입니다: 타입이 지정된 도구, dry-run 우선 쓰기, 멱등성, 인간 승인 훅, 그리고 변조 방지 감사 추적을 표준 MCP 서버로 패키징하여 Claude Desktop, Claude Code, Cursor, Codex 또는 모든 MCP 클라이언트에서 작동합니다.

Related MCP server: TallyPrime MCP Server

상태

빠른 시작

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 또는 더 좁은 범위)를 가진 self-client OAuth 리프레시 토큰이 필요하며, Zoho API 콘솔에서 생성합니다. 자격 증명은 환경 변수 대신 파일 기반 볼트(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. 쓰기(기본적으로 dry-run): 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