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이 로컬에서 실행 중이고 포트 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