Tally MCP

Tally의 내장 XML-HTTP 게이트웨이를 사용하여 Claude를 TallyPrime에 직접 연결하는 MCP (Model Context Protocol) 서버입니다. Claude Desktop 또는 Claude Code를 Tally 인스턴스에 연결하고 원장 읽기, 시산표 가져오기, 일계표 요약, 전표 초안 작성(승인 후 전기)을 요청할 수 있습니다 — 모두 수동으로 내보내거나 가져올 필요 없이.

인도의 공인회계법인이 자체 고객 회계 워크플로우에 사용하기 위해 개발하고 오픈소스로 공개했습니다. Tally Solutions 또는 Anthropic과 공식적으로 제휴하고 있지 않습니다.

이 도구로 할 수 있는 일

연결되면 Claude에게 다음과 같은 작업을 요청할 수 있습니다:

• "2026-03-31 기준 시산표를 보여줘"

• "ABC Traders의 원장을 가져와 최근 10개 항목을 요약해줘"

• "GST 세율 18%인 모든 재고 품목을 나열해줘"

• "오늘 날짜로 매출 전표를 생성해줘: 채무자 XYZ ₹1,18,000, 매출 ₹1,00,000, 출력 CGST ₹9,000, 출력 SGST ₹9,000" — Claude가 먼저 미리보기를 보여줍니다. 승인하기 전에는 Tally에 아무것도 기록되지 않습니다.

⚠️ 안전 모델 — 사용 전에 읽어보세요

이 커넥터는 현재 열려 있는 Tally 회사에 대해 전체 읽기/쓰기 액세스 권한을 가질 수 있습니다. 세 가지 보호 계층이 내장되어 있습니다:

1. 기본적으로 드라이런(dry-run) 모드. 모든 쓰기 도구(tally_create_voucher, tally_create_ledger, tally_create_stock_item)는 전송할 정확한 XML 미리보기를 반환하며, "confirm": true로 호출하지 않는 한 Tally에 아무 작업도 수행하지 않습니다. 도구 설명은 Claude에게 항상 미리보기를 보여주고 먼저 승인을 받도록 지시합니다. 하지만 승인하기 전에 표시된 내용을 직접 읽어보세요. 제어 지점으로 Claude만 의존하지 마십시오.

2. 회사 잠금. .env에는 TALLY_COMPANY_NAME이 필요합니다. 쓰기 전에 서버는 이 정확한 회사가 Tally에서 열려 있는지 다시 확인합니다. 서버 시작 후 다른 회사가 열린 경우 쓰기는 차단되며, 조용히 리디렉션되지 않습니다.

3. 감사 로그. 모든 도구 호출(읽기 또는 쓰기, 드라이런 또는 실제)은 audit/tally-mcp-audit.log에 JSON 라인으로 추가됩니다: 타임스탬프, 도구, 입력, 전송된 XML, Tally의 응답 및 상태.

전역 킬 스위치도 있습니다: .env에서 DRY_RUN_ONLY=true로 설정하면 confirm 값과 관계없이 모든 쓰기 도구가 미리보기 전용 모드로 강제됩니다 — 처음으로 실데이터를 테스트할 때 유용합니다.

이것은 안전을 고려한 통합을 위한 템플릿이지 보장이 아닙니다. 프로덕션 회계 데이터에 적용하기 전에 특히 src/tallyClient.ts와 src/tools/writeTools.ts 코드를 검토하세요.

사전 요구 사항

• Node.js 18+

• TallyPrime에서 ODBC/HTTP 연결이 활성화되어 있어야 합니다 (Gateway of Tally → F1 (도움말) → 설정 → 연결 → HTTP 활성화, 기본 포트 9000)

• 연결하려는 회사는 MCP 서버를 시작하기 전에 Tally에서 열려 있어야 합니다

설정

git clone https://github.com/<your-username>/tally-mcp.git
cd tally-mcp
npm install
cp .env.example .env

.env 편집:

TALLY_URL=http://localhost:9000
TALLY_COMPANY_NAME=<exact company name as shown in Tally>
DRY_RUN_ONLY=false

빌드:

npm run build

정상적으로 시작되는지 스모크 테스트:

npm start
# Expect: [tally-mcp] Connected. Tally URL: ..., Company lock: "...", DRY_RUN_ONLY: false
# Ctrl+C to stop.

Claude Desktop에 연결

Claude Desktop MCP 구성(claude_desktop_config.json)에 추가:

{
  "mcpServers": {
    "tally": {
      "command": "node",
      "args": ["/absolute/path/to/tally-mcp/dist/index.js"],
      "env": {
        "TALLY_URL": "http://localhost:9000",
        "TALLY_COMPANY_NAME": "Your Company Name",
        "DRY_RUN_ONLY": "false"
      }
    }
  }
}

Claude Desktop을 다시 시작하세요. 연결된 도구/MCP 서버 아래에 "tally"가 표시되어야 합니다.

Claude Code에 연결

claude mcp add tally -- node /absolute/path/to/tally-mcp/dist/index.js

환경 변수를 셸, 래퍼 스크립트 또는 작업 디렉터리의 .env를 통해 설정하세요 (dotenv로 자동 로드됩니다).

도구 참조

읽기 (확인 불필요)

쓰기 (기본적으로 드라이런, "confirm": true 필요)

아키텍처

Claude (Desktop/Code)
      │  MCP protocol (stdio)
      ▼
tally-mcp server (Node.js/TypeScript)
      │  XML over HTTP
      ▼
TallyPrime (XML-HTTP gateway, default port 9000)

src/
├── index.ts              # MCP server entry point, tool registry
├── config.ts              # .env loading + validation
├── types.ts                # Shared TypeScript types
├── tallyClient.ts         # HTTP transport to Tally + company-lock check
├── zodToJsonSchema.ts     # Zod → MCP tool schema converter
├── xml/
│   ├── builder.ts         # Builds Tally XML requests
│   └── parser.ts          # Parses Tally XML responses
├── tools/
│   ├── readTools.ts       # Read-only tool handlers
│   └── writeTools.ts      # Write tool handlers (dry-run/confirm gate)
└── audit/
    └── auditLogger.ts     # Append-only JSONL audit trail

알려진 제한 사항 / 로드맵

• tally_alter_voucher 유형은 존재하지만 도구가 아직 연결되지 않았습니다 — 기존 전표를 수정하려면 Tally의 XML 스키마에서 전표 번호로 조회하는 추가 단계가 필요합니다. PR 환영합니다.

• 전용 GST 보고 도구(GSTR-1/3B 요약)는 아직 없습니다 — 현재 tally_get_daybook + tally_get_ledger가 대부분의 조정 요구를 충족하지만, 목적에 맞는 GST 요약 도구가 있으면 좋은 추가가 될 것입니다.

• 자격 증명은 일반 .env입니다. 로컬/단일 사용자 용도로는 괜찮습니다. 팀 또는 여러 클라이언트 인스턴스를 위해 배포하는 경우 적절한 비밀 관리자를 연결하는 것을 고려하세요.

• 실행 중인 서버 인스턴스당 단일 회사 — .env의 TALLY_COMPANY_NAME 잠금은 Tally 회사당 하나의 서버 프로세스를 가정합니다. 다중 회사 지원(회사 이름을 .env 잠금 대신 호출별 매개변수로 사용)은 관심이 있다면 합리적인 Phase 2입니다.

위 사항에 대한 기여는 언제나 환영합니다 — CONTRIBUTING.md를 참조하세요.

라이선스

MIT — LICENSE 참조. 이 소프트웨어는 실제 회계 시스템에 연결됩니다. 드라이런 미리보기를 검토하고 자체 Tally 연결을 보호할 책임은 사용자에게 있습니다. 운영 지침은 SECURITY.md를 참조하세요.