real-mcp — Wooritech Real-* MCP Tools

real-mcp 는 Model Context Protocol(MCP) 기반의 RealGrid, RealReport, RealChart, RealMap 등 멀티-프로덕트 서버로 문서/리소스에 접근할 수 있게 해줍니다.

패키지: real-mcp | 버전: 1.0.0

주요 요약:

• 빠른 실행: npx real-mcp로 즉시 사용 가능
• CLI 및 stdio 기반 MCP 서버를 제공하여 LangChain 등 MCP 클라이언트와 연동

지원 Node 버전: node >= 18

설치 (간단)

• npx (권장 — 설치 불필요):

npx real-mcp

• 전역 설치:

npm install -g real-mcp

빠른 사용법 (npx)

• 기본 실행 (production 기본 설정 사용):

npx real-mcp

프로그램적 사용 (MCP 클라이언트 예시)

LangChain의 @langchain/mcp-adapters 같은 클라이언트에서 npx real-mcp를 stdio로 실행하도록 설정하면, 에이전트가 MCP를 통해 서버에서 제공하는 툴과 리소스에 접근할 수 있습니다.

예시 (간단한 구성):

// 예: @langchain/mcp-adapters 사용 시
import { MultiServerMCPClient } from '@langchain/mcp-adapters';

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

const tools = await client.getTools();
// 사용 후 종료
await client.close();

CLI/실행 옵션

• 이 패키지는 dist/index.js를 통해 CLI로 동작하며, 기본적으로 MCP stdio 서버를 시작합니다.

Examples

• 저장소의 examples/ 디렉터리 참조:
  • examples/langchain-client.ts — @langchain/mcp-adapters 사용 예
  • examples/agent-example.ts — 에이전트 통합 예

실행 예시(빌드 후):

npm run build
npx tsx examples/langchain-client.ts

문제 해결 팁

• npx real-mcp가 실패하면 로컬에서 먼저 npm run build 후 node dist/index.js로 실행해 보세요.
• Node 버전을 확인하세요: node -v (최소 v18 이상 권장)

라이선스

• Wooritech Inc.

배포 (Release)

• 사전 준비: npm에 로그인되어 있어야 합니다.

npm login

• 버전 업데이트(자동으로 Git 태그 생성) — 패치/마이너/메이저 중 선택:

npm version patch    # 또는 minor, major

• 빌드:

npm run build

• npm에 배포 (공개 패키지인 경우):

npm publish --access public

• Git에 푸시 및 태그 푸시:

git push
git push --tags

• (선택) GitHub 릴리스 생성(gh CLI 사용):

gh release create vX.Y.Z -t "vX.Y.Z" -n "Release notes"

위 절차는 로컬에서 수동으로 배포할 때 유용합니다. CI/CD에서 자동으로 릴리스하려면 레포지토리 설정과 권한(토큰, npm 권한 등)을 확인하세요.