Skip to main content
Glama
Sign In
vanam-erp-mcp

vanam-erp-mcp

by LeeJunHeon
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

vanam-erp-mcp

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

데이터 흐름:

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

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

제공 도구

도구

설명

입력

search_items

재고 품목을 이름이나 코드로 검색. 품목의 id, code, name, category를 반환

query (string, 필수)

get_stock

특정 품목의 현재 재고 수량 조회. itemCode, itemName, currentQty를 반환

itemId (number, 필수)

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

Related MCP server: erp-billing

요구 사항

설치

npm install

환경변수

.env.example를 참고하세요.

변수

설명

MCP_API_TOKEN

재고앱 내부 API 인증용 머신 토큰. 재고앱 .env의 MCP_API_TOKEN과 같은 값이어야 합니다.

INVENTORY_API_BASE

재고앱 내부 API 베이스 URL. 기본값 http://192.168.0.210:3000 (NAS 내부 IP)

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

도구

내부 API

search_items

GET /api/internal/items?search={query}

get_stock

GET /api/internal/stock?itemId={itemId}

Available Tools

2 tools
get_stockA

특정 품목의 현재 재고 수량을 조회한다. 품목 id가 필요하다(search_items로 먼저 찾을 것). itemCode, itemName, currentQty를 반환한다.

Inputs: itemId (required).

search_itemsA

재고 품목을 이름이나 코드로 검색한다. 예: 'VO2', '타겟'. 품목의 id, code, name, category를 반환한다. 재고 수량을 알려면 이 도구로 먼저 품목 id를 찾은 뒤 get_stock을 호출하라.

Inputs: query (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4.3/5.0

    Scored across 2 tools

    Disambiguation5/5

    Each tool has a distinct purpose: search_items finds item IDs based on name/code, while get_stock retrieves stock quantity for a specific item. There is no functional overlap.

    Naming Consistency5/5

    Both tools use a consistent verb_noun pattern (search_items, get_stock) with snake_case, making the naming predictable and clear.

    Tool Count3/5

    With only 2 tools, the server feels undersized for an ERP system. While they form a minimal query workflow, a typical inventory toolset would include more operations.

    Completeness2/5

    The tools only cover searching items and querying stock levels. Missing CRUD operations for items and stock adjustments leave significant gaps for an inventory management server.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Odoo MCP Server

      deeprunnerai
      A
      license
      B
      quality
      D
      maintenance
      An MCP server that enables AI assistants to interact with Odoo ERP apps like Inventory, CRM, Sales, and Manufacturing. It allows users to read, create, and manage Odoo records and workflows using natural language commands.
      25
      15 npm
      1
      ISC

    • erp-billing

      757607106
      F
      license
      Not graded
      quality
      B
      maintenance
      MCP server that enables AI platforms to search products, customers, and warehouses, and prepare and submit sales orders to a fixed ERP endpoint with per-session bearer authentication.
      -

    • ERP-lite MCP Server

      josephkamau32
      A
      license
      A
      quality
      C
      maintenance
      MCP server that exposes ERP functionalities to AI agents, enabling read-only queries for sales orders and inventory, and human-in-the-loop purchase requisition creation and approval.
      5
      9
      MIT

    • vndly-mcp

      coburn2716
      A
      license
      A
      quality
      D
      maintenance
      MCP server for VNDLY inventory and order management, enabling AI assistants to search products, list orders, and get low stock alerts.
      3
      11 npm
      MIT