vanam-erp-mcp

사내 AI 챗봇용 재고 조회 MCP 서버입니다.

데이터 흐름:

사내 포털 → OpenClaw → (이 MCP 서버) → 재고앱 내부 API → DB

이 서버는 조회 전용입니다. 쓰기(입고/출고/수정) 도구는 제공하지 않습니다.

제공 도구

재고 수량을 알려면 먼저 search_items로 품목 id를 찾은 뒤, 그 id로 get_stock을 호출합니다.

Related MCP server: MCP Product Management System

요구 사항

• Node.js 24 이상

• 의존성: @modelcontextprotocol/sdk (별도 빌드 단계 없음, 순수 JS)

설치

npm install

환경변수

.env.example를 참고하세요.

MCP_API_TOKEN은 절대 git에 커밋하지 마세요. (.gitignore에 .env 포함)

실행

node server.js

이 서버는 stdio 기반 MCP 서버이므로, 직접 실행하면 표준 입력을 기다리며 멈춰 있는 것이 정상입니다. 보통은 OpenClaw 같은 MCP 클라이언트가 자식 프로세스로 실행합니다.

OpenClaw 등록 예시

MCP 서버 설정에 다음과 같이 추가합니다 (예시):

{
  "mcpServers": {
    "vanam-erp": {
      "command": "node",
      "args": ["/절대경로/vanam-erp-mcp/server.js"],
      "env": {
        "MCP_API_TOKEN": "<재고앱과 동일한 머신 토큰>",
        "INVENTORY_API_BASE": "http://192.168.0.210:3000"
      }
    }
  }
}

동작 방식

• 모든 호출은 Authorization: Bearer <MCP_API_TOKEN> 헤더로 재고앱 내부 API에 요청합니다.

• 호출 타임아웃은 15초입니다.

• API 오류·네트워크 오류가 발생해도 예외를 던지지 않고, 에이전트가 이해할 수 있도록 오류 설명 텍스트를 응답에 담아 반환합니다.

호출하는 내부 API