Skip to main content
Glama
@mobilpay/mcp-server

@mobilpay/mcp-server

by KGMobilians

@mobilpay/mcp-server

npm version License: MIT

Это сервер MCP (Model Context Protocol) для интеграции платежных сервисов KG Financial.

Если вы зададите вопрос на естественном языке в инструментах ИИ-кодинга (Cursor, Claude Code, Kiro, VS Code, Windsurf, Claude Desktop и т. д.), он автоматически выполнит поиск по документации по интеграции платежей (27 документов) и сгенерирует точный код.

Поддерживаемые сервисы

Сервис

Описание

Кол-во документов

MOBILPAY REST API

Универсальная интеграция платежей (мобильный телефон/кредитная карта/банковский перевод/виртуальный счет/простая оплата/Mobile T-money)

18

NEZO (내죠여왕)

Сервис запроса платежей через Kakao AlimTalk

9

Related MCP server: samsung-checkout-mcp

Установка и настройка

  • Требуется Node.js 18+ (цель ES2022)

  • Используется протокол передачи stdio — сеть не требуется, возможна автономная работа

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"]
    }
  }
}

Предоставляемые инструменты

Общие

Инструмент

Ввод

Функция

get-docs

keywords: string[]

Интегрированный поиск по документам на основе BM25 (интеграция платежей + 27 документов NEZO)

document-by-id

id: number

Просмотр полного содержимого по ID документа. Используйте id=0 для просмотра списка документов

Интеграция платежей MOBILPAY

Инструмент

Ввод

Функция

get-payment-api-spec

api_name: string

Просмотр полной спецификации MOBILPAY API

get-payment-code-example

api_name, language?

Извлечение примеров кода MOBILPAY по языкам

NEZO (내죠여왕)

Инструмент

Ввод

Функция

get-nezo-api-spec

api_name: string

Просмотр полной спецификации API NEZO

get-nezo-code-example

api_name, language?

Извлечение примеров кода NEZO по языкам

Поддерживаемая документация

MOBILPAY REST API

Категория

Документы

API

Регистрация транзакции (включая T-money Pay), вызов платежного окна, ответ аутентификации/одобрения, одобрение платежа (TID), ручное списание, виртуальный счет, отмена платежа (/MUP/api/cancellation), возврат средств, регистрация доставки эскроу, кассовый чек, проверка целостности HMAC

Руководство

Руководство по применению, поток обычных платежей, поток гибридных платежей, обработка noti_url, настройка брандмауэра

Справочник

Таблица кодов способов оплаты/карточных компаний/финансовых учреждений, таблица кодов ошибок

NEZO (내죠여왕)

Категория

Документы

API

Запрос платежа (/send), URL обратного вызова/возврата, запрос платежа (/send/view), отмена платежа (/cancel), повторный запрос платежа

Руководство

Начало работы, настройка брандмауэра

Справочник

Общие коды ответов, руководство по созданию/проверке MAC

Примеры использования

В инструментах ИИ-кодинга можно задавать вопросы следующим образом:

MOBILPAY

  • "Напиши код для интеграции оплаты мобильным телефоном через MOBILPAY"

  • "Покажи полную спецификацию API регистрации транзакций"

  • "Дай пример кода на Python для проверки HMAC"

  • "Какие параметры у API отмены платежа?"

NEZO

  • "Напиши код для запроса платежа через AlimTalk в NEZO"

  • "Реализуй обработчик обратного вызова NEZO на Node.js"

  • "Покажи пример на Java для создания MAC в NEZO"

  • "Создай код для запроса платежа в NEZO, а затем его отмены"

Правила безопасности

MCP-сервер автоматически применяет следующие правила при генерации кода:

MOBILPAY

  1. skey (сервисный ключ) категорически запрещено включать в клиентский код — загружайте из переменных окружения

  2. Проверка целостности HMAC должна выполняться только на стороне сервера — структура сообщений различается для разных эндпоинтов (регистрация/одобрение транзакции / отмена/возврат / регистрация доставки эскроу)

  3. При обработке noti_url обязательна логика защиты от дублирования транзакций (идемпотентность на основе tid)

  4. API одобрения платежа (/MUP/api/approval) должен вызываться только с бэкенда

  5. Для отмены/возврата платежа используйте /MUP/api/cancellation с проверкой хеша (старый /cancel запрещен)

  6. Тест: test.mobilians.co.kr / Продакшн: mup.mobilians.co.kr

NEZO

  1. svc_id и MAC_KEY категорически запрещено включать в клиентский код — загружайте из переменных окружения

  2. Создание/проверка HmacSHA256 MAC должны выполняться только на стороне сервера

  3. В обработчике callback_url обязательна логика защиты от дублирования транзакций (идемпотентность на основе trade_no)

  4. Тест: test.mpps.co.kr / Продакшн: www.nezo.co.kr

Принцип работы

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    → 내죠여왕 코드 예제

При запуске сервера выполняется разбиение на чанки входящих в комплект документов в формате Markdown (27 шт.) и построение индекса 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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers