etf-flow-mcp

ETF 流量 MCP

MCP 服务器提供加密 ETF 流动数据，为 AI 代理的决策提供支持。

特征

• 统一工具： get_etf_flow工具动态获取 BTC 或 ETH 的历史 ETF 流量数据。
• Markdown 表输出：利用数据透视表来呈现数据，其中 ETF 代码作为列、日期作为行、总流量作为总列。
• 提示指导：包括提示（ etf_flow_prompt ）以简化 LLM 交互，实现用户友好的查询。

先决条件

• Python ：版本 3.10 或更高版本。
• uv ：一个快速的 Python 包和项目管理器（安装说明）。
• CoinGlass API 密钥：从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 桌面：将服务器添加到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 许可。