@junis/erp-junis-mcp

영림원 K-System OpenAPI MCP server.

npm 패키지명: @junis/erp-junis-mcp (npm scope: junis) bin 명령어: junis-mcp-erp (또는 erp-junis-mcp)

설치 / 실행

npx 로컬 실행 (개발)

npm install
npm run build
ERP_BASE_URL=<your-erp-base-url> \
  ERP_CERT_ID=<your-cert-id> \
  ERP_CERT_KEY=<your-cert-key> \
  ERP_DSN_OPER=<your-dsn-oper> \
  ERP_DSN_BIS=<your-dsn-bis> \
  ERP_COMPANY_SEQ=<your-company-seq> \
  ERP_SECURITY_TYPE=<your-security-type> \
  npx tsx src/index.ts

Claude Code / MCP 클라이언트 설정 예시

~/.claude.json 또는 클라이언트별 MCP 설정에 인증값을 환경변수로 주입:

{
  "mcpServers": {
    "junis-erp": {
      "command": "npx",
      "args": ["-y", "@junis/erp-junis-mcp"],
      "env": {
        "ERP_BASE_URL": "<your-erp-base-url>",
        "ERP_CERT_ID": "<your-cert-id>",
        "ERP_CERT_KEY": "<your-cert-key>",
        "ERP_DSN_OPER": "<your-dsn-oper>",
        "ERP_DSN_BIS": "<your-dsn-bis>",
        "ERP_COMPANY_SEQ": "<your-company-seq>",
        "ERP_SECURITY_TYPE": "<your-security-type>"
      }
    }
  }
}

⚠️ 모든 인증값은 연결하는 측이 환경변수로 주입합니다. 본 레포 코드/문서에는 어떤 인증값도 포함되어 있지 않습니다. 운영 환경에서는 secret manager / 환경별 설정을 통해 주입하세요.

환경변수

| 변수 | 필수 | 기본값 | 설명 | |---|---|---|---| | ERP_BASE_URL | ✅ | — | 영림원 K-System 서버 base URL | | ERP_CERT_ID | ✅ | — | ERP 인증 ID | | ERP_CERT_KEY | ✅ | — | ERP 인증 키 | | ERP_DSN_OPER | ✅ | — | 운영 DSN (회사별 다름) | | ERP_DSN_BIS | ✅ | — | 비즈니스 DSN (회사별 다름) | | ERP_COMPANY_SEQ | ✅ | — | 회사 시퀀스 (회사별 다름) | | ERP_SECURITY_TYPE | ✅ | — | 보안 타입 (회사 정책별 다름) | | ERP_LANGUAGE_SEQ | | 1 | 언어 시퀀스 | | ERP_BULK_CONCURRENCY | | 5 | bulk 호출 병렬 수 |

⚠️ 위 필수 환경변수는 회사별/환경별 다른 값입니다. 호출하는 측에서 모두 환경변수로 주입해야 합니다. 본 레포 코드/문서 어디에도 이 값들이 포함되어 있지 않습니다.

도구 4개

| 도구 | 용도 | ERP API | |---|---|---| | erp_get_prices_for_skus | 거래처별 단가 (카탈로그 빌드) · 추가 메타 (custName/itemClassName/lastUpdatedAt) + 시점 단가 (baseDate) 지원 | BSSSLCustItemPrice (2026-04-29 채택 · 기존 BSSDACustSLPrice 대체) | | erp_get_lot_manufacturing_dates | LOT 제조일자 — 거래처 유통기한 한계 > 65% 특수 검증 (일반 신호등은 WMS B2B-WH 만으로 충분) | BSSPDOSPDelvList_wsh + BSSPDOSPDelv_wsh + BSSPUDelvItemList | | erp_match_customer | 거래처 매칭 + 휴면 판정 | BSSDACustInfo | | erp_get_product_status | 상품 운영 상태 조회 | BSSAPIDAItem |

자세한 input/output 스키마는 클라이언트의 tools/list 응답 참조.

개발

npm install
npm run typecheck
npm run dev    # tsx 로 핫 실행
npm run build  # dist/ 생성

라이선스

UNLICENSED — 내부용.