MCP Bitpanda Server

MCP Bitpanda Server

Bitpanda API と連携するためのツールを公開する Model Context Protocol（MCP）サーバーです。このサーバーを使用すると、MCP プロトコル経由で取引、ウォレット、トランザクションなどの Bitpanda の機能にプログラムからアクセスできます。

前提条件

• Node.js（v18 以降を推奨）
• npm（Node.js に付属）
• Bitpanda API キー（環境変数 BITPANDA_API_KEY として設定）
• （任意）MCP 対応クライアントまたはランナー（例：VSCode 拡張機能、CLI）

セットアップ

1. リポジトリをクローンするか、プロジェクトディレクトリにいることを確認します。

2. 依存関係をインストールします：

   npm install
   

3. サーバーをビルドします：

   npm run build
   

   コンパイル済みの JavaScript コードを含む build ディレクトリが作成されます。

Smithery 経由でのインストール

Smithery 経由で Claude Desktop に MCP Bitpanda Server を自動的にインストールするには：

npx -y @smithery/cli install @matteoantoci/mcp-bitpanda --client claude

サーバーの実行

• 直接実行：

  node build/index.js
  

  または、start スクリプトがある場合：

  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（文字列、必須）：「day」または「week」のいずれかです。
  • 注：このツールに API キーは必要ありません。

• list_trades：Bitpanda API からユーザーのすべての取引を一覧表示します。新しい取引が先に表示されます。レスポンスはカーソル方式でページネーションされます。

  • パラメーター：
    • type（文字列、任意）：buy または sell のいずれかです。
    • cursor（文字列、任意）：クライアントが把握している最後の取引の ID です。この ID より後の取引のみが返されます。カーソルパラメーターが空、または指定されていない場合は、最初から取引が返されます。
    • page_size（整数、任意）：ページネーションされたレスポンスのページサイズです。

• list_asset_wallets：Bitpanda API からユーザーのすべての資産ウォレットを資産タイプ別に一覧表示します。

  • パラメーター：なし。

• list_fiat_wallets：Bitpanda API からユーザーのすべての法定通貨ウォレットを一覧表示します。

  • パラメーター：なし。

• list_fiat_transactions：Bitpanda API からユーザーのすべての法定通貨取引を一覧表示します。新しい法定通貨取引が先に表示されます。レスポンスはカーソル方式でページネーションされます。

  • パラメーター：
    • type（文字列、任意）：buy、sell、deposit、withdrawal、transfer、refund のいずれかです。
    • status（文字列、任意）：pending、processing、finished、canceled のいずれかです。
    • cursor（文字列、任意）：クライアントが把握している最後の法定通貨取引の ID です。この ID より後の法定通貨取引のみが返されます。カーソルパラメーターが空、または指定されていない場合は、最初から法定通貨取引が返されます。
    • 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 より後の暗号資産取引のみが返されます。カーソルパラメーターが空、または指定されていない場合は、最初から暗号資産取引が返されます。
    • page_size（整数、任意）：ページネーションされたレスポンスのページサイズです。

• list_commodity_transactions：Bitpanda API からユーザーのすべての商品取引を一覧表示します。新しい商品取引が先に表示されます。レスポンスはカーソル方式でページネーションされます。

  • パラメーター：
    • cursor（文字列、任意）：クライアントが把握している最後の商品取引の ID です。この ID より後の商品取引のみが返されます。カーソルパラメーターが空、または指定されていない場合は、最初から商品取引が返されます。
    • page_size（整数、任意）：ページネーションされたレスポンスのページサイズです。

拡張

Bitpanda API のエンドポイントをツールとして追加するには、src/tools/ に新しいツールファイルを実装し、src/tools/index.ts に登録してください。