MCP Bitpandaサーバー

Bitpanda APIと連携するためのツールを公開するモデルコンテキストプロトコル（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ディレクトリが作成されます。

サーバーの実行

• 直接：

  node build/index.js

  または、開始スクリプトがある場合:

  npm run start

• MCPランナー経由： MCPクライアントをstdioトランスポートを使用してサーバーを実行するように設定します。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に登録します。