@portlogics/toms-mcp

TOMS 일반화주용 MCP 서버. Claude Desktop / Claude Code 에서 TOMS 오더 조회, 화물 추적, 대시보드 요약을 자연어로 수행한다.

설치

npx @portlogics/toms-mcp

또는 전역 설치:

npm install -g @portlogics/toms-mcp

환경변수

| 변수 | 필수 | 설명 | |------|------|------| | TOMS_MCP_PROFILE | 선택 | 환경 프로필 — dev / staging / prod (기본값: prod) | | TOMS_MCP_USERNAME | 선택 | TOMS 로그인 username | | TOMS_MCP_PASSWORD | 선택 | TOMS 로그인 password | | TOMS_MCP_LOG_LEVEL | 선택 | 로그 레벨 (기본값: info) |

username/password 설정 시 서버 시작과 동시에 자동 로그인.

Claude Desktop 설정

~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "toms": {
      "command": "npx",
      "args": ["-y", "@portlogics/toms-mcp"],
      "env": {
        "TOMS_MCP_USERNAME": "your_username",
        "TOMS_MCP_PASSWORD": "your_password"
      }
    }
  }
}

설정 후 Claude Desktop 재시작.

Claude Code 설정

프로젝트 .mcp.json:

{
  "mcpServers": {
    "toms": {
      "command": "npx",
      "args": ["-y", "@portlogics/toms-mcp"],
      "env": {
        "TOMS_MCP_USERNAME": "your_username",
        "TOMS_MCP_PASSWORD": "your_password"
      }
    }
  }
}

Claude Code 실행 후 /mcp 로 연결 확인.

사용 예시

Claude 에서 자연어로:

• "내 오더 현황 알려줘" → 대시보드 요약
• "BL번호 PORTA2410004 오더 찾아줘" → BL 필터 검색
• "오더 1764 상세 보여줘" → 오더 상세
• "오더 1764 화물 어디 있어?" → 화물 위치 추적
• "항공 수출 오더만 검색해줘" → 필터 조합 검색
• "PO 검색해줘" → Purchase Order 검색

Tool 목록

| Tool | 설명 | |------|------| | toms_login | [TOMS 로그인] 세션 초기화. 환경변수 설정 시 자동 실행 | | get_order | [오더 상세] orderId로 HouseBL 상세 조회 | | search_orders | [오더 검색] 자유검색 + 구조화 필터 (BL번호, 운송모드, 날짜 등) | | track_cargo | [화물 추적] 현재 위치/상태 요약 (해상/항공) | | get_dashboard_summary | [대시보드] 오더 현황 — 전체/진행중/완료 건수 | | get_order_search_filters | [검색 필터 조회] 사용 가능한 필터 목록 | | search_purchase_orders | [PO 검색] Purchase Order 목록 검색 | | get_purchase_order | [PO 상세] Purchase Order 상세 조회 |

라이선스

MIT