kingdee-mcp-proxy 🐟

프로덕션 등급 MCP 프록시로 AI 에이전트(Claude / Cursor / 모든 MCP 클라이언트)가 Kingdee Cloud Galaxy(金蝶云星空) ERP를 안전하게 조회할 수 있게 합니다 — 읽기 전용 모드, 쓰기 확인 게이트, 전체 감사 로깅 포함.

AI 에이전트가 자연어로 金蝶云星空 ERP를 안전하게 조회/조작할 수 있게 합니다: 읽기 전용 모드, 쓰기 작업 확인 게이트, 전체 감사 로그.

⚡ 실전 검증 완료: 2026년 8월부터 프로덕션에서 운영 중이며, 공식 Kingdee OpenAPI(ExecuteBillQuery)를 통해 매일 실제 ERP 데이터를 조회합니다.

왜 이 프로젝트가 필요한가

Kingdee용 커뮤니티 MCP 커넥터는 일반적으로 AI에게 마스터 키를 넘겨줍니다: 관리자 자격 증명, 프롬프트에 포함된 원시 비밀번호, 제한 없는 쓰기, 감사 추적 없음. 그렇게 하면 AI가 구매 주문을 삭제하는 사고가 발생합니다.

이 프로젝트는 제로 트러스트 방식을 채택합니다:

빠른 시작

git clone https://github.com/YOUR_NAME/kingdee-mcp-proxy.git
cd kingdee-mcp-proxy
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt

cp .env.example .env   # fill in your Kingdee integration account
python -m proxy.server              # stdio mode (Claude Desktop / WorkBuddy)
python -m proxy.server --transport sse --host 0.0.0.0 --port 8181   # team-shared SSE mode

MCP 클라이언트를 여기에 연결하세요:

{ "mcpServers": { "kingdee": {
    "command": "python",
    "args": ["/path/to/proxy/server.py"],
    "env": { "READONLY": "true" } } } }

그런 다음 그냥 물어보세요: "지난달 자재 입고 문서를 조회해줘" → 완료.

도구

읽기 전용: query_bill(일반 청구서 조회) · view_bill(청구서 상세) · health

쓰기(READONLY=false일 때만 등록되며, 항상 게이트 적용): preview_save_bill → preview_submit_bills → preview_audit_bills → confirm_action

Kingdee 측 설정(5분)

1. 金蝶 백엔드: 시스템 관리 → 타사 시스템 로그인 인증 → 추가

2. 전용 통합 계정(Administrator 아님)을 만들고 필요한 조회 모듈만 부여

3. AppID / AppSecret / AcctID를 .env에 복사

전체 체크리스트: 보안 체크리스트 (작업 중)

비즈니스 가치

• CFO/IT 관리자용: 보안 허점 없이 모든 직원에게 ERP 데이터에 대한 AI 분석가를 제공

• 호환: Claude Desktop, Cursor, WorkBuddy 또는 모든 MCP 호환 에이전트

• 맞춤 ERP×AI 통합(UFIDA/SAP/자체 구축 시스템)도 진행합니다: → 아래 연락처

이중 라이선스

• 오픈 소스: AGPL-3.0

• 폐쇄 소스 제품에 포함하거나 SLA 지원이 필요하면 상용 라이선스 제공 → [commercial] 제목의 issue를 열어주세요

연락처

• Issue 및 PR 환영

• 맞춤 통합 문의: Discussions에 댓글 남겨주세요

• 맞춤형 기업 AI 구축(MCP 개발 / 프라이빗 배포 / Agent 워크플로우): issue를 제기하거나 이메일로 연락주세요

⭐ 이 프로젝트가 일주일의 작업을 절약해줬다면, 스타를 눌러주세요 — 다른 중국 ERP 팀이 이 프로젝트를 찾는 데 도움이 됩니다.