@junis/erp-junis-mcp

Wishcompany ERP (영림원 K-System OpenAPI) MCP server for Junis B2B.

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

설치 / 실행

npx 로컬 실행 (개발)

npm install
npm run build
ERP_CERT_ID=<your-cert-id> ERP_CERT_KEY=<your-cert-key> 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": "http://erp.wishcompany.net",
        "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": "0"
      }
    }
  }
}

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

환경변수

| 변수 | 필수 | 기본값 | 설명 | |---|---|---|---| | ERP_CERT_ID | ✅ | — | ERP 인증 ID | | ERP_CERT_KEY | ✅ | — | ERP 인증 키 | | ERP_DSN_OPER | ✅ | — | 운영 DSN (회사별 다름) | | ERP_DSN_BIS | ✅ | — | 비즈니스 DSN (회사별 다름) | | ERP_COMPANY_SEQ | ✅ | — | 회사 시퀀스 (회사별 다름) | | ERP_SECURITY_TYPE | ✅ | — | 보안 타입 (회사 정책별 다름, 일반 0) | | ERP_BASE_URL | | http://erp.wishcompany.net | ERP 서버 base URL | | ERP_LANGUAGE_SEQ | | 1 | 언어 시퀀스 (한국어 1 고정 가능) | | ERP_BULK_CONCURRENCY | | 5 | bulk 호출 병렬 수 |

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

도구 4개

| 도구 | 용도 | ERP API | |---|---|---| | erp_get_prices_for_skus | 거래처별 단가 (카탈로그 빌드) | 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 — Junis 내부용.