ironflowsh

@ironflowsh/mcp

适用于 Ironflow 的 MCP 服务：为 Claude、Cursor 和任何 MCP 客户端提供只读 Hyperliquid 市场数据和钱包分析。涵盖原生永续合约、HIP-3 构建者市场、HIP-4 结果市场和现货市场。提供 36 个工具，全部为只读工具，包括 run_query，用于对所有 Hyperliquid 成交、钱包、资金费率和清算表执行只读 SQL 查询。

无需 API 密钥即可开始使用：无密钥调用每分钟限 10 次请求，并可访问 24 小时历史数据。通过 ironflow.sh/key 获取免费密钥后，每分钟请求限额提升至 60 次，历史数据范围延长至 30 天。

示例问题

“过去 24 小时内金额最大的 Hyperliquid 清算有哪些？”

“显示 HIP-3 市场当前的资金费率。”

“列出正在运行的 HIP-4 结果市场。”

“总结这个钱包过去 30 天的情况：PnL、费用、做市商占比、已支付资金费。”

托管服务（无需安装）

通过 URL 连接：https://mcp.ironflow.sh/mcp（Streamable HTTP）。

# Claude Code
claude mcp add --transport http ironflow https://mcp.ironflow.sh/mcp

# with a free key
claude mcp add --transport http ironflow https://mcp.ironflow.sh/mcp \
  --header "Authorization: Bearer if_your_api_key"

Claude 桌面版和 claude.ai：依次进入 Settings → Connectors → Add custom connector，然后粘贴 URL。

Cursor（~/.cursor/mcp.json 或项目的 .cursor/mcp.json）：

{
  "mcpServers": {
    "ironflow": { "url": "https://mcp.ironflow.sh/mcp" }
  }
}

无法发送请求头的客户端可以在 URL 中通过 ?key=if_your_api_key 传递密钥。

本地服务

npx -y @ironflowsh/mcp

需要 Node.js 18+。Claude Desktop 配置文件（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 上为 %APPDATA%/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "ironflow": {
      "command": "npx",
      "args": ["-y", "@ironflowsh/mcp"],
      "env": { "IRONFLOW_API_KEY": "if_your_api_key" }
    }
  }
}

env 块为可选项。Claude Code：claude mcp add ironflow -- npx -y @ironflowsh/mcp。

如需自行托管 HTTP 服务：npx -y -p @ironflowsh/mcp ironflow-mcp-http（监听 PORT，默认值为 8080，路径为 /mcp）。

工具

随意提问（SQL）： describe_data 列出可查询的表、列和示例查询；run_query 对这些表执行一条只读 ClickHouse SELECT 查询（涵盖每笔成交、每个钱包的每日汇总、行为标签、资金费率、标记价格和预言机价格、未平仓量、清算、构建者代码成交、转账、金库资金流）；get_wallet_behavior 返回每个钱包过去 30 天的交易风格标签。无密钥查询可查看最近 24 小时的数据；免费密钥可查看 30 天的数据。

市场数据： get_price、get_recent_trades、get_candles、get_funding_rates、get_open_interest、get_liquidations、get_liquidation_summary、get_fills、get_mark_prices、get_vault_operations、list_markets、get_markets_snapshot

市场分析： get_funding_stats、get_pnl_leaderboard、get_market_top_wallets、get_wallet_labels、get_liquidation_levels 和 get_vault_leaderboard（这两个工具需要 Builder 或 Enterprise 密钥）

信号： get_top_traders、get_market_leaders、get_early_movers、get_trader_profile

钱包分析： get_user_state、get_user_summary、get_user_pnl_series、get_user_funding、get_user_maker_taker、get_user_ledger

群组： list_cohorts、get_cohort_addresses

状态： get_status、get_status_metrics、get_status_history

成交历史涵盖滚动 12 个月的数据。不提供订单簿、订单状态或流式传输工具。

配置

环境变量	默认值
IRONFLOW_API_KEY	可选；可通过 ironflow.sh/key 获取免费密钥
IRONFLOW_API_URL	https://api.ironflow.sh
PORT（HTTP 服务）	8080
MCP_LOG_SALT（HTTP 服务）	每个进程随机生成；用于生成访问日志中的调用者哈希值

使用数据

每次 API 调用都会携带两个请求头，以便我们了解用户使用的应用和工具：X-Ironflow-Client（MCP 客户端名称和版本，例如 claude-code/2.1.0）以及 X-Ironflow-Tool（工具名称）。托管服务会记录每个请求的方法、工具参数、客户端名称、状态，以及经过加盐处理的调用者 IP 哈希值。它绝不会记录 IP 或 API 密钥。

Links

• Docs: docs.ironflow.sh
• API reference: docs.ironflow.sh/api-reference
• Hyperliquid node guides: ironflow.sh/guides

License

MIT