Skip to main content
Glama
@mobilpay/mcp-server

@mobilpay/mcp-server

by KGMobilians

@mobilpay/mcp-server

npm version License: MIT

Este es un servidor MCP (Model Context Protocol) para la integración de los servicios de pago de KG Financial.

Al realizar preguntas en lenguaje natural en herramientas de codificación de IA (Cursor, Claude Code, Kiro, VS Code, Windsurf, Claude Desktop, etc.), puede buscar automáticamente en la documentación de integración de pagos (27 documentos) para generar código preciso.

Servicios compatibles

Servicio

Descripción

Cantidad de documentos

MOBILPAY REST API

Integración de pagos universal (teléfono móvil/tarjeta de crédito/transferencia bancaria/cuenta virtual/pago sencillo/T-money móvil)

18

NEZO (내죠여왕)

Servicio de solicitud de pago mediante Kakao AlimTalk

9

Related MCP server: samsung-checkout-mcp

Instalación y configuración

  • Requiere Node.js 18+ (objetivo ES2022)

  • Utiliza el método de transporte stdio: no requiere red, puede funcionar sin conexión

Cursor

.cursor/mcp.json:

{
  "mcpServers": {
    "mobilpay": {
      "command": "npx",
      "args": ["-y", "@mobilpay/mcp-server@latest"]
    }
  }
}

Claude Code (CLI)

claude mcp add mobilpay -- npx -y @mobilpay/mcp-server@latest

VS Code (GitHub Copilot)

.vscode/mcp.json:

{
  "servers": {
    "mobilpay": {
      "command": "npx",
      "args": ["-y", "@mobilpay/mcp-server@latest"]
    }
  }
}

Windsurf

.windsurf/mcp.json:

{
  "mcpServers": {
    "mobilpay": {
      "command": "npx",
      "args": ["-y", "@mobilpay/mcp-server@latest"]
    }
  }
}

Kiro (AWS)

.kiro/settings/mcp.json:

{
  "mcpServers": {
    "mobilpay": {
      "command": "npx",
      "args": ["-y", "@mobilpay/mcp-server@latest"]
    }
  }
}

Claude Desktop

claude_desktop_config.json:

{
  "mcpServers": {
    "mobilpay": {
      "command": "npx",
      "args": ["-y", "@mobilpay/mcp-server@latest"]
    }
  }
}

Herramientas proporcionadas

Comunes

Herramienta

Entrada

Función

get-docs

keywords: string[]

Búsqueda documental integrada basada en BM25 (integración de pagos + 27 documentos de NEZO)

document-by-id

id: number

Consulta el contenido completo por ID de documento. Use id=0 para ver la lista de documentos

Integración de pagos MOBILPAY

Herramienta

Entrada

Función

get-payment-api-spec

api_name: string

Consulta la especificación completa de la API de MOBILPAY

get-payment-code-example

api_name, language?

Extrae código de ejemplo de MOBILPAY por lenguaje

NEZO (내죠여왕)

Herramienta

Entrada

Función

get-nezo-api-spec

api_name: string

Consulta la especificación completa de la API de NEZO

get-nezo-code-example

api_name, language?

Extrae código de ejemplo de NEZO por lenguaje

Documentación de soporte

MOBILPAY REST API

Clasificación

Documento

API

Registro de transacciones (incluyendo T-money Pay), llamada a ventana de pago, respuesta de autenticación/aprobación, aprobación de pago (TID), captura manual, cuenta virtual, cancelación de pago (/MUP/api/cancellation), reembolso, registro de envío de depósito en garantía, recibo de efectivo, verificación de integridad HMAC

Guía

Guía de aplicación, flujo de pago general, flujo de pago híbrido, procesamiento de noti_url, configuración de firewall

Referencia

Tabla de códigos de medios de pago/emisores de tarjetas/instituciones financieras, tabla de códigos de error

NEZO (내죠여왕)

Clasificación

Documento

API

Solicitud de pago (/send), URL de callback/retorno, consulta de pago (/send/view), cancelación de pago (/cancel), re-solicitud de pago

Guía

Introducción, configuración de firewall

Referencia

Códigos de respuesta comunes, guía de creación/verificación de MAC

Ejemplos de uso

Puede preguntar en las herramientas de codificación de IA de la siguiente manera:

MOBILPAY

  • "Escribe código para la integración de pagos por teléfono móvil de MOBILPAY"

  • "Muéstrame la especificación completa de la API de registro de transacciones"

  • "Dime el código de ejemplo en Python para la verificación HMAC"

  • "¿Cuáles son los parámetros de la API de cancelación de pago?"

NEZO

  • "Escribe código para la solicitud de pago de AlimTalk de NEZO"

  • "Implementa un manejador de callback de NEZO en Node.js"

  • "Muéstrame un ejemplo en Java para la creación de MAC de NEZO"

  • "Crea código para consultar y luego cancelar un pago en NEZO"

Reglas de seguridad

El servidor MCP aplica automáticamente las siguientes reglas al generar código:

MOBILPAY

  1. skey (clave de servicio) nunca debe incluirse en el código del cliente; cárguela desde variables de entorno.

  2. La verificación de integridad HMAC debe procesarse siempre en el lado del servidor; la composición del mensaje varía según el endpoint (registro/aprobación de transacciones / cancelación/reembolso / registro de envío de depósito en garantía).

  3. Al procesar noti_url, es obligatoria la lógica de prevención de transacciones duplicadas (idempotencia basada en tid).

  4. La API de aprobación de pago (/MUP/api/approval) debe llamarse siempre desde el backend.

  5. Para cancelación/reembolso de pago, utilice /MUP/api/cancellation que incluye verificación de hash (prohibido usar el antiguo /cancel).

  6. Prueba: test.mobilians.co.kr / Producción: mup.mobilians.co.kr

NEZO

  1. svc_id y MAC_KEY nunca deben incluirse en el código del cliente; cárguelos desde variables de entorno.

  2. La creación/verificación de HmacSHA256 MAC debe procesarse siempre en el lado del servidor.

  3. En el manejador de callback_url, es obligatoria la lógica de prevención de transacciones duplicadas (idempotencia basada en trade_no).

  4. Prueba: test.mpps.co.kr / Producción: www.nezo.co.kr

Principio de funcionamiento

AI 도구 → MCP 프로토콜 → 6개 Tool 중 선택 → 문서 검색/조회 → 결과 반환
                          ├── get-docs                → 통합 BM25 키워드 검색
                          ├── document-by-id           → 문서 ID 기반 조회
                          ├── get-payment-api-spec     → MOBILPAY API 명세
                          ├── get-payment-code-example → MOBILPAY 코드 예제
                          ├── get-nezo-api-spec        → 내죠여왕 API 명세
                          └── get-nezo-code-example    → 내죠여왕 코드 예제

Al iniciar el servidor, se divide en fragmentos la documentación Markdown incluida (27 documentos) y se construye un índice BM25.

Available Tools

6 tools
document-by-idA

문서 ID로 KG파이낸셜 결제서비스 연동 문서 전체를 조회합니다. (MOBILPAY REST API + 내죠여왕 알림톡 결제)

get-docs 검색 결과에서 특정 문서의 전체 내용이 필요할 때 사용합니다. ID 목록은 이 Tool을 id=0으로 호출하면 확인할 수 있습니다.

Inputs: id (required).

get-docsC

KG파이낸셜 결제서비스 연동 문서를 검색합니다. (MOBILPAY REST API + 내죠여왕 알림톡 결제)

지원 문서: [MOBILPAY] 거래등록(티머니페이 포함), 결제창 호출, 인증/승인 응답, 결제승인(TID), 수동매입, 가상계좌, 결제취소(/cancellation), 환불, 에스크로 배송등록, 현금영수증, HMAC 무결성 검증, 결제플로우(일반/하이브리드), noti_url 처리, 방화벽 설정, 에러코드표, 결제수단/카드사/금융기관 코드표 [내죠여왕] 결제요청(/send), 콜백/리턴URL, 결제조회(/send/view), 결제취소(/cancel), 결제재요청, MAC 생성/검증, 응답코드, 방화벽 설정

보안 규칙 (생성 코드에 반드시 준수): [MOBILPAY]

  1. skey(서비스키)는 절대 클라이언트 코드에 포함 금지. 환경변수에서 로드.

  2. HMAC 무결성 검증은 반드시 서버 사이드에서 처리.

  3. noti_url 처리 시 중복 거래 방어 로직(tid 기반 멱등성) 필수.

  4. 결제 승인 API(/MUP/api/approval)는 반드시 백엔드에서 호출.

  5. 테스트: test.mobilians.co.kr / 운영: mup.mobilians.co.kr [내죠여왕]

  6. svc_id와 MAC_KEY는 절대 클라이언트 코드에 포함 금지. 환경변수에서 로드.

  7. HmacSHA256 MAC 생성/검증은 반드시 서버 사이드에서 처리.

  8. callback_url 처리 시 중복 거래 방어 로직(trade_no 기반 멱등성) 필수.

  9. 테스트: test.mpps.co.kr / 운영: www.nezo.co.kr

Inputs: keywords (required).

get-nezo-api-specA

내죠여왕(NEZO) 알림톡 결제서비스 API의 전체 명세를 조회합니다.

요청/응답 파라미터, 예제 코드를 포함한 전체 문서를 반환합니다. 키워드 검색이 아닌 특정 API를 정확히 조회할 때 사용합니다.

사용 가능한 api_name: send(결제요청), callback(콜백/리턴URL), search(결제조회), cancel(결제취소), resend(재요청), start(시작하기), mac(MAC검증가이드), 응답코드(response-codes), 방화벽(firewall)

보안 규칙:

  1. svc_id와 MAC_KEY는 절대 클라이언트 코드에 포함 금지. 환경변수에서 로드.

  2. HmacSHA256 MAC 생성/검증은 반드시 서버 사이드에서 처리.

  3. callback_url 핸들러에 trade_no 기반 멱등성 로직 필수.

  4. 테스트: test.mpps.co.kr / 운영: www.nezo.co.kr

Inputs: api_name (required).

get-nezo-code-exampleB

내죠여왕(NEZO) 알림톡 결제서비스의 언어별 예제 코드를 조회합니다.

문서에 포함된 코드 블록을 언어 필터링하여 반환합니다. MAC 가이드 문서에 Java, C#, Node.js, Python, PHP 예제가 포함되어 있습니다.

보안 규칙:

  1. svc_id와 MAC_KEY는 환경변수에서 로드. 절대 클라이언트 코드에 포함 금지.

  2. MAC 생성/검증은 반드시 서버 사이드에서 처리.

Inputs: api_name (required), language.

get-payment-api-specA

MOBILPAY REST API의 전체 명세를 조회합니다.

요청/응답 파라미터, 예제 코드를 포함한 전체 문서를 반환합니다. 키워드 검색이 아닌 특정 API를 정확히 조회할 때 사용합니다.

사용 가능한 api_name: registration(거래등록), payment-window(결제창), auth-response(인증응답), approval-tid(결제승인), purchase(수동매입), virtual-account(가상계좌), cancellation(결제취소), refund(환불), escrow-delivery(에스크로 배송등록), cash-receipt(현금영수증), hmac(HMAC검증)

보안 규칙:

  1. skey(서비스키)는 절대 클라이언트 코드에 포함 금지. 환경변수에서 로드.

  2. HMAC 무결성 검증은 반드시 서버 사이드에서 처리.

  3. 결제 승인 API(/MUP/api/approval)는 반드시 백엔드에서 호출.

Inputs: api_name (required).

get-payment-code-exampleA

MOBILPAY REST API의 언어별 예제 코드를 조회합니다.

문서에 포함된 코드 블록을 언어 필터링하여 반환합니다. HMAC 검증 문서에는 Java, C#, Node.js, Python, PHP 예제가 포함되어 있습니다.

보안 규칙:

  1. skey는 환경변수에서 로드. 절대 클라이언트 코드에 포함 금지.

  2. HMAC 검증, 결제 승인은 반드시 서버 사이드에서 처리.

Inputs: api_name (required), language.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a distinct purpose: searching docs, retrieving a specific doc by ID, and fetching API specs or code examples for two separate services (MOBILPAY and NEZO). No overlap or ambiguity.

    Naming Consistency4/5

    Most tools follow a 'get-{service}-{type}' pattern for specs and examples, but 'document-by-id' and 'get-docs' break the pattern slightly. Overall, the naming is clear and predictable.

    Tool Count5/5

    6 tools cover all essential needs for a documentation server: search, ID-based retrieval, specs, and code examples for two APIs. Neither too few nor too many.

    Completeness5/5

    The set provides complete access to documentation: search, full document retrieval, specific API specs, and code examples. No obvious gaps in coverage for the stated domain.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers