vanam-erp-mcp

vanam-erp-mcp

MCP server for querying inventory items and stock levels via internal API, enabling AI chatbots to look up product codes and current quantities.

Category
Visit Server

README

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을 호출합니다.

요구 사항

설치

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}

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured