real-mcp — Wooritech Real-* MCP Tools

Model Context Protocol(MCP) 서버로 RealGrid, RealReport, RealChart, RealMap 등 Real-* 제품의 문서·리소스에 접근합니다.

패키지: real-mcp | 버전: 1.0.7 | Node: >= 18

• npx real-mcp로 바로 실행
• stdio MCP (Cursor, Claude, LangChain 등)
• HTTP / Streamable HTTP (https://real-mcp.wooritech.com)
• 기동 시 ${BASE_URL}/api/v1/products에서 제품 목록 로드

설치 · 실행

npx real-mcp
# 또는
npm install -g real-mcp && real-mcp

HTTP 모드:

npx real-mcp http
# PORT=8080 npx real-mcp http   # 기본 포트 3100

Cursor / MCP 클라이언트

{
  "mcpServers": {
    "real-mcp": {
      "command": "npx",
      "args": ["-y", "real-mcp"],
      "env": {
        "BASE_URL": "https://gray-parrot.wooritech.com"
      }
    }
  }
}

선택 env: DISABLED_PRODUCTS (쉼표 구분 제품 code), LOG_LEVEL=debug

HTTP(Streamable HTTP)로 붙일 때는 URL만 등록합니다.

{
  "mcpServers": {
    "real-mcp": {
      "url": "https://real-mcp.wooritech.com/mcp"
    }
  }
}

LangChain 예시

import { MultiServerMCPClient } from '@langchain/mcp-adapters';

const client = new MultiServerMCPClient({
  mcpServers: {
    'real-mcp': {
      transport: 'stdio',
      command: 'npx',
      args: ['-y', 'real-mcp'],
    },
  },
});

const tools = await client.getTools();
await client.close();

Tools

| Tool | 용도 | |------|------| | get_product_info | 활성 제품 목록/정보 | | search_resources | 키워드 문서 검색 (uri, pageContent) | | list_resources | 카테고리별 목록 (examples / guides / references / config) | | get_resource | 문서 본문 (uri 또는 product/category/name) | | list_dts_files | npm 패키지 .d.ts 목록 (UNPKG) | | get_package_file | npm 패키지 파일 내용 (UNPKG) |

환경변수

| 변수 | 설명 | |------|------| | BASE_URL | 문서 API 베이스 (기본 https://gray-parrot.wooritech.com) | | DISABLED_PRODUCTS | 비활성 제품 code, 쉼표 구분 (예: realmap,realchart) | | LOG_LEVEL | debug 시 stderr에 tool/search 추적 로그 | | PORT | HTTP 모드 포트 (기본 3100) |

기동 시 products API를 1회 호출하며, 실패하면 서버는 기동하지 않습니다. 로그는 stdout(JSON-RPC)과 분리해 stderr로만 출력합니다.

에이전트 워크플로

서버 instructions에 안내됩니다.

1. Real-* 질문은 웹 검색보다 이 MCP를 우선
2. 범위 불명확 → get_product_info
3. 키워드 → search_resources → 필요 시 get_resource(uri)
4. 목록 탐색 → list_resources → get_resource
5. API 타입 → list_dts_files → get_package_file

HTTP 엔드포인트

호스팅: https://real-mcp.wooritech.com — GET /health, POST /mcp

서버는 stateless(세션 없음)이고 POST /mcp는 JSON 한 개로 답합니다. GET /mcp·DELETE /mcp는 MCP 스펙대로 405를 돌려줍니다. 요청에는 Accept: application/json, text/event-stream 헤더가 필요합니다(SDK 클라이언트는 자동으로 보냅니다).

라이선스

ISC — Wooritech / RealGrid

저장소 개발·빌드·배포는 DEVELOPMENT.md를 참고하세요.