@mobilpay/mcp-server

This is an MCP (Model Context Protocol) server for integrating KG Financial's payment services.

By asking questions in natural language within AI coding tools (Cursor, Claude Code, Kiro, VS Code, Windsurf, Claude Desktop, etc.), you can automatically search through 27 payment integration documents to generate accurate code.

Supported Services

Related MCP server: samsung-checkout-mcp

Installation and Setup

• Node.js 18+ required (ES2022 target)

• Uses stdio transport — no network required, works offline

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

Provided Tools

Common

MOBILPAY Payment Integration

NEZO

Supported Documents

MOBILPAY REST API

NEZO

Usage Examples

You can ask questions in AI coding tools as follows:

MOBILPAY

• "Write code for MOBILPAY mobile phone payment integration"

• "Show me the full specification for the transaction registration API"

• "Show me a Python example code for HMAC verification"

• "What are the parameters for the payment cancellation API?"

NEZO

• "Write code for NEZO Notification Talk payment request"

• "Implement a NEZO callback handler in Node.js"

• "Show me a Java example for NEZO MAC generation"

• "Create code to inquire about a NEZO payment and then cancel it"

Security Rules

The MCP server automatically applies the following rules when generating code:

MOBILPAY

1. skey (Service Key) must never be included in client-side code — load from environment variables

2. HMAC integrity verification must be handled on the server side — message composition varies by endpoint (Transaction registration/Approval, Cancellation/Refund, Escrow delivery registration)

3. noti_url processing must include duplicate transaction prevention logic (idempotency based on tid)

4. Payment approval API (/MUP/api/approval) must be called from the backend

5. Use /MUP/api/cancellation (which includes hash verification) for payment cancellation/refunds (do not use the old /cancel)

6. Test: test.mobilians.co.kr / Production: mup.mobilians.co.kr

NEZO

1. svc_id and MAC_KEY must never be included in client-side code — load from environment variables

2. HmacSHA256 MAC generation/verification must be handled on the server side

3. callback_url handler must include duplicate transaction prevention logic (idempotency based on trade_no)

4. Test: test.mpps.co.kr / Production: www.nezo.co.kr

How It Works

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

Upon server startup, the bundled markdown documents (27 files) are chunked and indexed using BM25.