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)

Kakao 提醒消息支付请求服务

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

服务器启动时,会对打包的 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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers