Skip to main content
Glama
@mobilpay/mcp-server

@mobilpay/mcp-server

by KGMobilians

@mobilpay/mcp-server

npm version License: MIT

KG Financialの決済サービス連携のためのMCP(Model Context Protocol)サーバーです。

AIコーディングツール(Cursor, Claude Code, Kiro, VS Code, Windsurf, Claude Desktopなど)で自然言語で質問すると、決済連携ドキュメント(27件)を自動検索し、正確なコードを生成できます。

対応サービス

サービス

説明

ドキュメント数

MOBILPAY REST API

汎用決済連携 (携帯電話/クレジットカード/口座振替/仮想口座/簡易決済/モバイルT-money)

18件

内緒の女王(NEZO)

カカオ通知トーク決済リクエストサービス

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件のドキュメント)

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全仕様照会

get-nezo-code-example

api_name, language?

内緒の女王言語別サンプルコード抽出

対応ドキュメント

MOBILPAY REST API

分類

ドキュメント

API

取引登録(T-money Pay含む)、決済ウィンドウ呼び出し、認証/承認応答、決済承認(TID)、手動売上、仮想口座、決済キャンセル(/MUP/api/cancellation)、返金、エスクロー配送登録、現金領収書、HMAC整合性検証

ガイド

適用ガイド、一般決済フロー、ハイブリッド決済フロー、noti_url処理、ファイアウォール設定

リファレンス

決済手段/カード会社/金融機関コード表、エラーコード表

内緒の女王(NEZO)

分類

ドキュメント

API

決済リクエスト(/send)、コールバック/リターンURL、決済照会(/send/view)、決済キャンセル(/cancel)、決済再リクエスト

ガイド

はじめに、ファイアウォール設定

リファレンス

共通応答コード、MAC生成/検証ガイド

使用例

AIコーディングツールで以下のように質問してください:

MOBILPAY

  • "MOBILPAY携帯電話決済連携コードを作成して"

  • "取引登録APIの全仕様を見せて"

  • "HMAC検証のPythonサンプルコードを教えて"

  • "決済キャンセルAPIのパラメータは何?"

内緒の女王

  • "内緒の女王の通知トーク決済リクエストコードを作成して"

  • "内緒の女王のコールバックハンドラーをNode.jsで実装して"

  • "内緒の女王のMAC生成Javaサンプルを見せて"

  • "内緒の女王の決済照会後にキャンセルするコードを作って"

セキュリティルール

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

内緒の女王

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

サーバー起動時にバンドルされたマークダウンドキュメント(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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers