MCP 비트판다 서버

Bitpanda API와 상호 작용하기 위한 도구를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 MCP 프로토콜을 통해 거래, 지갑, 거래 등 Bitpanda 기능에 프로그래밍 방식으로 접근할 수 있습니다.

필수 조건

• Node.js(v18 이상 권장)

• npm(Node.js와 함께 제공)

• Bitpanda API 키( BITPANDA_API_KEY 환경 변수로 설정)

• (선택 사항) MCP 호환 클라이언트 또는 러너(예: VSCode 확장, CLI)

설정

1. 저장소를 복제하거나 프로젝트 디렉토리에 있는지 확인하세요.

2. 종속성 설치:

   지엑스피1

3. 서버를 빌드하세요:

   npm run build

   이렇게 하면 컴파일된 JavaScript 코드가 포함된 build 디렉토리가 생성됩니다.

서버 실행

• 곧장:

  node build/index.js

  또는 시작 스크립트가 있는 경우:

  npm run start

• MCP 러너를 통해: stdio 전송을 사용하여 서버를 실행하도록 MCP 클라이언트를 구성합니다. MCP 설정 항목 예시:

  "mcp-bitpanda": { "transportType": "stdio", "command": "node", "args": [ "/path/to/mcp-bitpanda/build/index.js" ] // Add environment variables, e.g., for the API key "environmentVariables": { "BITPANDA_API_KEY": "YOUR_BITPANDA_API_KEY" // Replace with your actual API key or use a secure method to provide it } // ... other optional settings ... }

사용 가능한 도구

• get_asset_info : 특정 자산에 대한 자세한 정보를 해당 기호(예: BTC, XAU)별로 검색합니다.

  • 매개변수: symbol (문자열, 필수)

  • 참고: 이 도구에는 API 키가 필요하지 않습니다.

• get_ohlc : 특정 자산, 법정 통화 및 기간에 대한 OHLC(시가/고가/저가/종가) 데이터를 검색합니다.

  • 매개변수:

    • symbol (문자열, 필수): 거래 심볼입니다.

    • fiatCurrency (문자열, 필수): 법정 통화(예: USD, EUR).

    • timeframe (문자열, 필수): "일" 또는 "주"입니다.

  • 참고: 이 도구에는 API 키가 필요하지 않습니다.

• list_trades : Bitpanda API에서 사용자의 모든 거래를 나열합니다. 최신 거래가 먼저 표시됩니다. 응답은 커서를 기준으로 페이지 번호가 매겨집니다.

  • 매개변수:

    • type (문자열, 선택 사항): buy 또는 sell 중 하나.

    • cursor (문자열, 선택 사항): 클라이언트가 마지막으로 확인한 거래의 ID입니다. 이 ID 이후의 거래만 반환됩니다. cursor 매개변수가 비어 있거나 누락되면 처음부터 거래가 반환됩니다.

    • page_size (정수, 선택 사항): 페이지 분할 응답의 페이지 크기입니다.

• list_asset_wallets : Bitpanda API에서 자산 유형별로 그룹화된 모든 사용자 자산 지갑을 나열합니다.

  • 매개변수: 없음.

• list_fiat_wallets : Bitpanda API에서 사용자의 모든 법정 화폐 지갑을 나열합니다.

  • 매개변수: 없음.

• list_fiat_transactions : Bitpanda API에서 사용자의 모든 법정화폐 거래를 나열합니다. 최신 법정화폐 거래가 먼저 표시됩니다. 응답은 커서로 페이지 번호를 매겨 표시됩니다.

  • 매개변수:

    • type (문자열, 선택 사항): 매수, 매도, 입금, 출금, 이체, 환불.

    • status (문자열, 선택 사항): 보류, 처리 중, 완료, 취소됨.

    • cursor (문자열, 선택 사항): 클라이언트가 마지막으로 확인한 법정화폐 거래의 ID입니다. 이 ID 이후의 법정화폐 거래만 반환됩니다. cursor 매개변수가 비어 있거나 누락되면 처음부터 법정화폐 거래가 반환됩니다.

    • page_size (정수, 선택 사항): 페이지 분할 응답의 페이지 크기입니다.

• list_crypto_wallets : Bitpanda API에서 사용자의 모든 암호화폐 지갑을 나열합니다.

  • 매개변수: 없음.

• list_crypto_transactions : Bitpanda API에서 사용자의 모든 암호화폐 거래를 나열합니다. 최신 암호화폐 거래가 먼저 표시됩니다. 응답은 커서로 페이지 번호가 매겨집니다.

  • 매개변수:

    • type (문자열, 선택 사항): buy , sell , deposit , withdrawal , transfer , refund 또는 ico 중 하나.

    • status (문자열, 선택 사항): pending , processing , unconfirmed_transaction_out , open_invitation , finished 또는 canceled 중 하나.

    • cursor (문자열, 선택 사항): 클라이언트가 마지막으로 확인한 암호화 거래의 ID입니다. 이 ID 이후의 암호화 거래만 반환됩니다. cursor 매개변수가 비어 있거나 누락되면 처음부터 암호화 거래가 반환됩니다.

    • page_size (정수, 선택 사항): 페이지 분할 응답의 페이지 크기입니다.

• list_commodity_transactions : Bitpanda API에서 사용자의 모든 상품 거래를 나열합니다. 최신 상품 거래가 먼저 표시됩니다. 응답은 커서로 페이지 번호를 매겨 표시됩니다.

  • 매개변수:

    • cursor (문자열, 선택 사항): 클라이언트가 마지막으로 확인한 상품 거래의 ID입니다. 이 ID 이후의 상품 거래만 반환됩니다. cursor 매개변수가 비어 있거나 누락되면 처음부터 상품 거래가 반환됩니다.

    • page_size (정수, 선택 사항): 페이지 분할 응답의 페이지 크기입니다.

확장

더 많은 Bitpanda API 엔드포인트를 도구로 추가하려면 src/tools/ 에 새 도구 파일을 구현하고 src/tools/index.ts 에 등록합니다.