ETF Flow MCP

ETF Flow MCP

AI エージェントの意思決定に役立つ暗号資産 ETF フローデータを提供する MCP サーバーです。

特長

• 統合ツール：get_etf_flow ツールは、BTC または ETH の過去の ETF フローデータを動的に取得します。
• Markdown テーブル出力：ピボットテーブルを活用し、ETF のティッカーを列、日付を行として、フローの合計を示す合計列とともにデータを表示します。
• プロンプトによるガイダンス：ユーザーが使いやすいクエリで LLM とのやり取りを効率化するプロンプト（etf_flow_prompt）が含まれています。

前提条件

• Python：バージョン 3.10 以降。
• uv：高速な Python パッケージおよびプロジェクト管理ツール（インストール手順）。
• CoinGlass API Key：CoinGlass からキーを取得してください。
• Claude Desktop：対話形式でクエリを実行する場合は任意です。
• Git：リポジトリのクローンに使用します。

インストール

1. リポジトリをクローンする：

   git clone https://github.com/kukapay/etf-flow-mcp.git
   cd etf-flow-mcp
   

2. uv でセットアップする： uv を使用して依存関係をインストールします：

   uv sync
   

使用方法

Claude Desktop との統合

1. Claude Desktop を設定する： claude_desktop_config.json（macOS では ~/Library/Application Support/Claude、Windows では %APPDATA%\Claude にあります）にサーバーを追加します：

   {
     "mcpServers": {
       "etf-flow-mcp": {
         "command": "uv",
         "args": ["--directory", "/absolute/path/to/etf-flow-mcp", "run", "etf-flow-mcp"],
         "env": { "COINGLASS_API_KEY": "your_coinglass_api_key_here" }
       }
     }
   }
   

   /absolute/path/to/etf-flow-mcp/cli.py を cli.py の完全なパスに置き換えてください。

2. Claude Desktop を再起動する： Claude Desktop の UI にハンマーアイコンが表示されることを確認し、サーバーが読み込まれたことを確かめます。

3. クエリの例：

   • 「最新の BTC ETF フローデータを表で表示してください」
   • 「ETH ETF のフロー履歴を取得してください」

出力例

• BTC ETF フロー：

  | Date       | GBTC      | IBIT      | FBTC      | ARKB      | BITB      | BTCO     | HODL     | BRRR     | EZBC     | BTCW     | Total     |
  |------------|-----------|-----------|-----------|-----------|-----------|----------|----------|----------|----------|----------|-----------|
  | 2025-04-24 | 0         | 327300000 | 0         | 97700000  | 10200000  | 7750000  | 0        | 0        | 0        | 0        | 442200000 |
  | 2025-04-23 | 0         | 643200000 | 124400000 | 129500000 | -15200000 | 0        | 5300000  | 0        | 0        | 0        | 917700000 |
  | 2025-04-22 | 65100000  | 193500000 | 253800000 | 267100000 | 76700000  | 18300000 | 6500000  | 0        | 10600000 | 0        | 912700000 |
  | 2025-04-21 | 36600000  | 41600000  | 88100000  | 116100000 | 45100000  | 0        | 11700000 | 0        | 10100000 | 0        | 381300000 |
  | 2025-04-18 | 0         | 0         | 0         | 0         | 0         | 0        | 0        | 0        | 0        | 0        | 0         |
  

• ETH ETF フロー：

  | Date       | ETHE      | GETH     | ETHA      | ETHW     | FETH      | ETHV     | EZET     | CETH     | QETH     | Total     |
  |------------|-----------|----------|-----------|----------|-----------|----------|----------|----------|----------|-----------|
  | 2025-04-24 | -6600000  | 18300000 | 40000000  | 5100000  | 0         | 2600000  | 0        | 4100000  | 0        | 63550000  |
  | 2025-04-23 | 0         | 6400000  | -30300000 | 0        | 0         | 0        | 0        | 0        | 0        | -23900000  |
  | 2025-04-22 | 0         | 0        | 0         | 6100000  | 32700000  | 0        | 0        | 0        | 0        | 38800000  |
  | 2025-04-21 | -25400000 | 0        | 0         | 0        | 0         | 0        | 0        | 0        | 0        | -25400000  |
  | 2025-04-18 | 0         | 0        | 0         | 0        | 0         | 0        | 0        | 0        | 0        | 0         |
  | 2025-04-17 | 0         | 0        | 0         | 0        | 0         | 0        | 0        | 0        | 0        | 0         |
  

ライセンス

このプロジェクトは MIT License の下でライセンスされています。