Bitrefill Search and Shop

비트리필 MCP 서버

TypeScript 기반 MCP 서버로, Bitrefill 서비스에 대한 액세스를 제공하여 기프트 카드, 모바일 충전 등을 검색할 수 있습니다. 이 서버는 모델 컨텍스트 프로토콜(Model Context Protocol)을 구현하여 AI 비서에게 Bitrefill 기능을 제공합니다.

작동 원리

서버는 Claude 및 유사한 AI 비서와 통신하기 위해 Model Context Protocol(MCP)을 사용합니다. 다음과 같은 기능을 합니다.

1. 통신을 위해 stdio를 사용하여 독립 실행형 프로세스로 실행됩니다.
2. Bitrefill 서비스에 액세스하기 위한 리소스 및 도구를 등록합니다.
3. 제품 검색 및 세부 정보를 제공하기 위해 Bitrefill API와 인터페이스합니다.
4. AI 어시스턴트가 처리할 수 있는 구조화된 JSON 응답을 반환합니다.

건축학

앱 서버는 다음 아키텍처를 따릅니다.

지엑스피1

특징

자원

• bitrefill://product-types - Bitrefill에서 사용 가능한 제품 유형 목록
• bitrefill://categories/{type} - 특정 제품 유형에 사용 가능한 카테고리 목록(예: bitrefill://categories/gift-cards )

도구

• search - 기프트 카드, eSIM, 모바일 충전 등을 검색하세요
  • 필수: query (예: 'Amazon', 'Netflix', 'AT&T' 또는 '*'(모두))
  • 선택 사항: country , language , limit , skip , category
• detail - 제품에 대한 자세한 정보를 얻으세요
  • 필수: id (제품 식별자)
• categories - 전체 제품 유형/카테고리 맵을 받으세요
  • 필수 매개변수 없음
• create_invoice - 제품 구매를 위한 새로운 송장을 생성합니다(API 키 필요)
  • 필수: products (송장에 포함할 제품 배열)
    • 각 제품에는 다음이 필요합니다: product_id
    • 선택 제품 필드: quantity , value , package_id , phone_number , email , send_email , send_sms
  • 필수: payment_method ("balance", "bitcoin", "lightning" 중 하나)
  • 선택 사항: webhook_url , auto_pay
• get_invoices - 선택적 필터링을 사용하여 송장 목록을 검색합니다.
  • 선택 사항: start , limit , after , before
• get_invoice - ID로 특정 송장에 대한 세부 정보 검색
  • 필수: id (송장 식별자)
• pay_invoice - 미납 송장 지불('balance' 결제 방법에만 적용)
  • 필수: id (송장 식별자)
• get_orders - 선택적 필터링을 사용하여 주문 목록을 검색합니다.
  • 선택 사항: start , limit , after , before
• get_order - ID로 특정 주문에 대한 세부 정보 검색
  • 필수: id (주문 식별자)
• unseal_order - ID별로 특정 주문에 대한 코드와 PIN을 공개합니다.
  • 필수: id (주문 식별자)
• get_account_balance - 계좌 잔액 검색
  • 필수 매개변수 없음
• ping - Bitrefill API를 사용할 수 있는지 확인하세요
  • 필수 매개변수 없음

구성

API 키 설정

search , categories , detail 제외한 Bitrefill API에 의존하는 모든 도구를 사용하려면 Bitrefill API 자격 증명을 설정해야 합니다.

1. Bitrefill 계정 만들기
2. 이 양식 에 요청을 제출하여 개발자 API 키를 요청하세요.
3. 루트 디렉토리에 .env 파일을 만듭니다( .env.example 에서 복사 가능)
4. Bitrefill API 자격 증명을 추가하세요.
   BITREFILL_API_SECRET=your_api_key_here BITREFILL_API_ID=your_api_id_here

create_invoice 도구는 API 사용자 인증 정보가 설정된 경우에만 사용할 수 있습니다. API 사용자 인증 정보가 설정되지 않으면 도구가 등록되지 않고 사용 가능한 도구 목록에 나타나지 않습니다.

개발

종속성 설치:

서버를 빌드하세요:

자동 재빌드를 사용한 개발의 경우:

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. 패키지 스크립트로 제공되는 MCP Inspector를 사용하는 것이 좋습니다.

검사기는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공합니다.

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 Bitrefill을 자동으로 설치하려면:

클로드 데스크탑

다음 위치에 서버 구성을 추가합니다.

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 윈도우: %APPDATA%/Claude/claude_desktop_config.json

클라인

1. Cline 확장 프로그램 설정을 엽니다.
2. "MCP 서버" 탭을 엽니다.
3. "MCP 서버 구성"을 클릭하세요.
4. 서버 구성을 추가합니다.

추가 Cline 구성 옵션:

• disabled : 서버를 활성화하려면 false 로 설정합니다.
• autoApprove : 각 사용에 대해 명시적 승인이 필요하지 않은 도구 목록

커서

1. 커서 설정을 엽니다
2. "기능" 설정 열기
3. "MCP 서버" 섹션에서 "새 MCP 서버 추가"를 클릭합니다.
4. 이름을 선택하고 "유형"으로 "명령"을 선택하세요.
5. "명령" 필드에 다음을 입력하세요.

6. (선택 사항) create_invoice 도구를 사용하는 경우 환경 변수를 추가합니다.
   • BITREFILL_API_SECRET: 귀하의 API 키를 여기에 입력하세요
   • BITREFILL_API_ID: 여기에 귀하의 API ID를 입력하세요

도커

Docker를 사용하여 서버를 실행할 수도 있습니다. 먼저 이미지를 빌드하세요.

그런 다음 컨테이너를 실행합니다.

개발을 위해 소스 코드를 볼륨으로 마운트할 수 있습니다.