暗号ETFフローデータをAIエージェントの意思決定に配信するMCPサーバー。

##特徴

-Unified Tool: [get_etf_flow]ツールは、BTCまたはETHの歴史的なETFフローデータを動的に取得します。

• 印表の出力: pivotテーブルを活用して、ETF ティッカーを列として表示したり、行として日付を設定したり、要約されたフローの合計列を格納したりできます。 -Prompt Guidance: プロンプト([[etf_flow_prompt])を含んだので、LLMのインタラクションをユーザーフレンドリーなクエリに合理化できます。

前提条件

-Python:バージョン3.10以上 -uv:高速なPythonパッケージとプロジェクトマネージャ(インストール手順)。

• CoinGlass API キー: CoinGlass からキーを得て下さい。 -Claude Desktop:オプション、インタラクティブなクエリ。 -Git: リポジトリをクローニングするために。

インストール

1. リポジトリのクローン:

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

使用法

##Claudeデスクトップとの統合

1.Claudeデスクトップの設定: macOS または %APPDATA%\Claude に claude_desktop_config.json] にサーバーを追加します。

/absolute/path/to/etf-flow-mcp/cli.py を cli.py] にフルパスで置換します。

ETF Flow MCP

An MCP server that delivers crypto ETF flow data to power AI agents’ decision-making.

Features

• Unified Tool: The get_etf_flow tool dynamically fetches historical ETF flow data for BTC or ETH.
• Markdown Table Output: Leverages pivot tables to present data with ETF tickers as columns, dates as rows, and a total column for summed flows.
• Prompt Guidance: Includes a prompt (etf_flow_prompt) to streamline LLM interactions for user-friendly queries.

Prerequisites

• Python: Version 3.10 or higher.
• uv: A fast Python package and project manager (install instructions).
• CoinGlass API Key: Obtain a key from CoinGlass.
• Claude Desktop: Optional, for interactive querying.
• Git: For cloning the repository.

Installation

1. Clone the Repository:

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

2. Set Up with uv: Install dependencies using uv:

   uv sync
   

Usage

Integrating with Claude Desktop

1. Configure Claude Desktop: Add the server to claude_desktop_config.json (located in ~/Library/Application Support/Claude on macOS or %APPDATA%\Claude on Windows):

   {
     "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" }
       }
     }
   }
   

   Replace /absolute/path/to/etf-flow-mcp/cli.py with the full path to cli.py.

2. Restart Claude Desktop: Verify the hammer icon appears in the Claude Desktop UI to confirm the server is loaded.

3. Query Examples:

   • “Show me the latest BTC ETF flow data in a table”
   • “Get the ETH ETF flow history”

Example Output

• BTC ETF Flow:

  | 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 |