NicePay MCP Server

나이스페이 개발자 가이드를 위한 Model Context Protocol (MCP) 서버입니다.

이 MCP 서버는 Cursor IDE나 다른 MCP 호환 도구에서 나이스페이 API 문서를 쉽게 검색하고 조회할 수 있도록 해줍니다.

참고: 이 프로젝트는 나이스페이먼츠 공식 매뉴얼 저장소의 마크다운 문서를 기반으로 작동합니다.

기능

1. 문서 검색 (search_nicepay_docs)

키워드로 나이스페이 개발자 가이드 문서를 검색합니다.

사용 예시:

• "결제창"
• "취소"
• "웹훅"
• "API"

2. API 엔드포인트 조회 (get_api_endpoint)

특정 API 엔드포인트의 상세 정보를 조회합니다.

조회 내용:

• HTTP Method (GET, POST 등)
• 엔드포인트 URL
• 요청/응답 파라미터
• 샘플 코드

사용 예시:

• "결제 승인"
• "거래 조회"
• "취소"

3. 코드 샘플 조회 (get_code_sample)

주제와 언어에 맞는 코드 샘플을 제공합니다.

사용 예시:

• 주제: "결제창 호출", 언어: "javascript"
• 주제: "Basic 인증", 언어: "curl"
• 주제: "결제 승인"

4. JS SDK 메서드 조회 (get_sdk_method)

JS SDK 메서드의 사용법과 파라미터 정보를 제공합니다.

사용 예시:

• "requestPay"
• "cancelPay"
• "AUTHNICE.requestPay"

설치

요구사항

• Node.js 18 이상
• npm 또는 yarn

설치 방법

1. 프로젝트 디렉토리로 이동:

cd mcp-server

2. 의존성 설치:

npm install

3. 빌드:

npm run build

사용 방법

Cursor IDE 설정

1. Cursor 설정 파일(.cursorrules 또는 MCP 설정)을 엽니다.

2. MCP 서버를 추가합니다:

{
  "mcpServers": {
    "nicepay": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"]
    }
  }
}

참고: 위 경로는 실제 프로젝트 경로로 변경해야 합니다.

개발 모드 실행

개발 중에는 tsx를 사용하여 실행할 수 있습니다:

npm run dev

프로덕션 빌드

npm run build
npm start

프로젝트 구조

mcp-server/
├── src/
│   ├── index.ts                 # MCP 서버 진입점
│   └── utils/
│       ├── docIndexer.ts        # 문서 인덱싱 시스템
│       ├── markdownParser.ts    # 마크다운 파서
│       └── logger.ts           # 로깅 유틸리티
├── dist/                        # 빌드 결과물
├── package.json
├── tsconfig.json
└── README.md

문서 경로

서버는 다음 디렉토리의 마크다운 파일들을 자동으로 인덱싱합니다:

• api/ - API 명세 문서
• common/ - 공통 가이드 문서
• management/ - 운영 관련 문서
• migration/ - 마이그레이션 문서

이 문서들은 나이스페이먼츠 공식 매뉴얼 저장소에서 제공됩니다.

문서 구조: 서버는 프로젝트 루트의 상위 디렉토리(../../)에서 위 디렉토리들을 찾아 인덱싱합니다. 공식 저장소를 클론한 경우, 이 MCP 서버를 해당 저장소의 하위 디렉토리로 배치하거나, DOCS_BASE_PATH 환경 변수로 문서 경로를 지정할 수 있습니다.

스크립트

• npm run build - TypeScript 컴파일
• npm start - 빌드된 파일 실행
• npm run dev - 개발 모드 실행 (tsx 사용)
• npm run watch - 파일 변경 감지하여 자동 빌드

로깅

서버는 stderr를 통해 로그를 출력합니다. 로그 레벨:

• ERROR - 오류 발생
• WARN - 경고 사항
• INFO - 정보성 메시지
• DEBUG - 디버그 정보

문제 해결

문서 인덱싱 실패

서버 시작 시 문서 인덱싱이 실패하면 로그를 확인하세요. 인덱싱이 실패해도 서버는 계속 실행되지만 검색 기능이 제한될 수 있습니다.

MCP 연결 실패

• Node.js 버전이 18 이상인지 확인
• 빌드가 완료되었는지 확인 (dist/index.js 파일 존재 여부)
• 경로가 올바른지 확인

검색 결과가 없을 때

• 키워드를 변경하여 다시 시도
• 대소문자는 구분하지 않으므로 자유롭게 입력 가능

라이선스

MIT

기여

이슈나 개선 사항이 있으면 알려주세요!