@kginicis/integration-guide-mcp

KG이니시스 결제 연동 가이드를 LLM 및 AI 에이전트가 쉽게 탐색하고 이해할 수 있도록 설계된 Model Context Protocol (MCP) 서버입니다. 이 서버는 KG이니시스의 API 명세서 데이터를 기반으로 연동 스펙 조회, 페이로드 유효성 검증, 언어별 예제 코드 생성, 모의 응답 시뮬레이션 기능을 제공합니다.

🚀 주요 기능 (Key Features)

• 결제 API 명세 조회 (get_spec): 요청한 엔드포인트 URL에 해당하는 마크다운 명세 데이터(필드 정보, 데이터 타입, 필수 여부 등)를 파싱하여 제공합니다.
• 페이로드 유효성 검증 (validate_payload): 사용자가 작성한 요청 페이로드(NVP 또는 JSON 포맷)가 API 규격에 부합하는지 정밀하게 검증합니다.
• 연동 코드 자동 생성 (generate_code): 공통 코드 템플릿(Java V1/V2, JavaScript V1/V2)을 기반으로 엔드포인트 규격에 최적화된 연동 예제 코드를 즉석에서 빌드합니다.
• 응답 시뮬레이션 (simulate_response): mock-responses.json에 정의된 실거래 응답 포맷을 매핑하여 가상의 성공 및 실패 응답 페이로드를 생성합니다.

📦 설치 방법 (Installation)

이 패키지는 npm 레지스트리를 통해 전역 설치하여 사용할 수 있습니다.

npm install -g @kginicis/integration-guide-mcp

또는 설치 없이 npx를 사용해 즉시 기동할 수도 있습니다.

npx @kginicis/integration-guide-mcp

🛠️ MCP 클라이언트 연동 설정 (Configuration)

{
  "mcpServers": {
    "kginicis-integration-guide": {
      "command": "npx",
      "args": ["-y", "@kginicis/integration-guide-mcp"]
    }
  }
}

🧩 제공하는 도구 (MCP Tools)

이 서버는 단일 진입 도구인 payment_support를 제공합니다.

payment_support

• 설명: 결제 연동 개발 보조 작업을 처리합니다.
• 입력 매개변수 (inputSchema):
  • action (string, 필수): 실행할 작업 유형
    • get_spec: 명세 데이터 조회
    • validate_payload: 요청 페이로드 유효성 검증
    • generate_code: 호출 코드 생성
    • simulate_response: 응답값 시뮬레이션
  • endpointPath (string, 선택): 대상 API 엔드포인트 URL (예: /v2/pg/refund, /api/v1/refund, /v2/pg/inquiry 등)
  • payload (string, 선택): validate_payload 시 검증할 JSON 또는 URL-encoded 형식의 문자열
  • language (string, 선택): generate_code 수행 시 타겟 언어 (java 또는 javascript, 기본값: java)
  • simulateStatus (string, 선택): simulate_response 시 응답 성공 여부 (success 또는 failure, 기본값: success)

호출 예시 (Tool Call JSON)

{
  "name": "payment_support",
  "arguments": {
    "action": "generate_code",
    "endpointPath": "/v2/pg/refund",
    "language": "javascript"
  }
}