Npay Payments MCP

Npay Payments MCP(Model Context Protocol)는 AI 에이전트가 네이버페이의 결제 도메인과 상호작용할 수 있도록 지원합니다.

주요 기능

• 네이버페이 문서 조회
  • 네이버페이 개발자센터

MCP Host 설정 예시

{
  "mcpServers": {
    "npay-payments": {
      "command": "npx",
      "args": ["@naverpay/payments-mcp"]
    }
  }
}

제공 도구

get_document

네이버페이 문서를 조회합니다.

매개변수

| 매개변수 | 타입 | 필수 | 설명 | 기본값 | |---------------|---------|------|------------------------|------------| | categoryId | string | ✅ | 문서 카테고리 ID | - | | path | string | ➖ | 문서 경로 | "overview" |

사용 가능한 카테고리

| 카테고리 ID | 제목 | 설명 | |---------------|--------------------------|----------------------------------------| | developers | 네이버페이 개발자센터 | 네이버페이 연동 가이드 및 API 레퍼런스 |

search_documents

키워드로 네이버페이 문서를 검색합니다.

• korean-noun-dictionary로 구축한 명사 사전을 활용해 llms-full.txt 문서를 인덱싱하여 최적화된 검색 결과를 제공합니다.

매개변수

| 매개변수 | 타입 | 필수 | 설명 | 기본값 | |---------------|---------|------|------------------------------------------------|--------| | categoryId | string | ✅ | 문서 카테고리 ID | - | | query | string | ✅ | 검색 키워드 | - | | limit | number | ➖ | 최대 결과 수 | 3 |

사용 가능한 카테고리

| 카테고리 ID | 제목 | 설명 | |---------------|--------------------------|----------------------------------------| | developers | 네이버페이 개발자센터 | 네이버페이 연동 가이드 및 API 레퍼런스 |

개발환경 요구사항

• Node.js: 22.11.0 이상
• pnpm: 9.12.3 이상

시작하기

# 의존성 설치
pnpm install

# 테스트 실행
pnpm test

# 패키지 빌드
pnpm build

개발 모드

외부 서버를 대신하는 로컬 테스트 서버와 MCP Inspector를 동시에 실행합니다.

# 개발 모드 실행
pnpm start

로컬 테스트 서버는 http://localhost:3001로 실행됩니다.

기여하기

버그 리포트나 기능 요청은 GitHub Issues에 등록해 주세요.

자세한 내용은 CONTRIBUTING.md를 참조하세요.

라이선스

Apache License v2.0 - 자세한 내용은 LICENSE 파일을 참조하세요.