SuperAPI AI 工具集

keel-trade

Keel 是一个围绕 Hyperliquid 链上永续合约订单簿构建的量化加密交易平台,涵盖策略开发、回测、实盘执行与投资组合管理。keel-trade 是该平台的公开 Python 包镜像,提供 CLI 与 stdio MCP 服务器:单次安装即可在终端或任意支持 MCP 的 AI 代理中使用相同工具。其核心理念是让 AI 助理负责用类型化的组件组合策略,而确定性引擎负责执行——策略编译为同一编译产物,在回测与实盘中做到逐位一致,LLM 不进入交易循环。用户可通过托管 MCP 端点或本地安装,让 Claude、Cursor、Codex 等代理搜索组件、组合策略、在真实 Hyperliquid 历史数据上回测并分享结果。平台还包含 Web 应用、确定性回测引擎、可复制的策略库,以及资金费率排行、动量、过拟合检查、前推可视化等筛选与计算工具。项目采用 MIT 许可证,当前处于 Alpha 阶段,CLI 与 MCP 表面稳定并定期发布至 PyPI。

访问官网

工具介绍

用途

Keel 是一个围绕 Hyperliquid 构建的量化加密交易平台,覆盖策略开发、回测、实盘执行与投资组合管理。keel-trade 是该平台的公开 Python 包镜像,也是面向 AI 代理的研究入口:它同时提供 CLI 与 stdio MCP 服务器,让用户在终端或任意支持 MCP 的代理中构建并回测 Hyperliquid 永续合约策略。平台本身还包括用于组合策略、运行回测和部署实盘的 Web 应用、确定性回测引擎、可复制的策略库,以及位于 usekeel.io/lab 的筛选与计算工具套件(资金费率排行榜、动量、过拟合检查、前推可视化等)。

主要能力

  • 类型化策略组合:策略是由版本化组件构成的图,编译错误在编写阶段而非生产环境中暴露。
  • 确定性回测:基于真实 Hyperliquid 历史数据,包含真实的资金费率、价格与滑点。
  • 逐位一致的实盘执行:同一编译策略产物在回测与 Hyperliquid 上运行,不存在可能产生偏差的第二套实现。
  • 代理组合,引擎执行:Claude / Cursor / Codex 帮助构建策略,但不进入交易循环。
  • MCP 工具集:默认本地工具集包括 always、read-only、backtest、share、live-read,覆盖状态、认证、组件、策略生命周期、回测、审计、账户、分享与只读实盘监控。
  • CLI 镜像:每个 MCP 结果工具都有 CLI 对应命令,便于终端、SSH、CI、脚本或偏好子进程调用的代理使用。

使用方式

托管 MCP(无需安装)

托管端点 URL:https://mcp.usekeel.io/mcp —— 一个端点,29 个研究/回测/读取工具,无需安装。认证使用 MCP 客户端自身的 OAuth 流程,而非工具调用。首次请求会返回带 OAuth 2.1 元数据的 401,合规客户端可自行发现登录步骤。

各客户端配置:

  • Claude:Customize → Connectors → Add custom connector,粘贴 https://mcp.usekeel.io/mcp 并选择 Connect。
  • ChatGPT:Settings → Security and login → 开启 Developer mode(需付费 ChatGPT 计划;Business/Enterprise 需管理员允许)。打开 chatgpt.com/plugins,选择 +,填写名称与描述,将 https://mcp.usekeel.io/mcp 作为 MCP 服务器 URL(包含 /mcp 路径)。
  • Claude Code:claude mcp add --transport http keel https://mcp.usekeel.io/mcp。在 Claude Code 内运行 /mcp 并选择 Authenticate。
  • Cursor:将服务器加入 .cursor/mcp.json(项目)或 ~/.cursor/mcp.json(全局):{"mcpServers": {"keel": {"url": "https://mcp.usekeel.io/mcp"}}}。Cursor 首次使用时要求登录。
  • Codex:codex mcp add keel --url https://mcp.usekeel.io/mcp,然后 codex mcp login keel。Codex 会打开浏览器登录。
  • Windsurf:将服务器加入 Windsurf 的 mcp_config.json:{"mcpServers": {"keel": {"serverUrl": "https://mcp.usekeel.io/mcp"}}}。Windsurf 首次使用时要求登录。
  • VS Code:将服务器加入 .vscode/mcp.json,或打开安装链接:{"servers": {"keel": {"type": "http", "url": "https://mcp.usekeel.io/mcp"}}}。VS Code 首次使用时要求登录。
  • 其他:使用客户端自带的 add remote / HTTP MCP 服务器流程,地址为 https://mcp.usekeel.io/mcp。

CLI + 本地 MCP(本包)

安装:uv tool install keel-trade 或 pipx 安装,需要 Python 3.11+。随后将 stdio MCP 命令注册到代理宿主。Cursor、Windsurf 及通用 MCP 客户端可参考 usekeel.io/keel-mcp#install 或代理设置指南。

Claude Desktop 一键安装(MCPB)

从最新 release 下载 keel-trade-<version>.mcpb 并拖入 Claude Desktop。跨平台单一包,支持 macOS、Windows 和 Linux。需要系统 Python 3.11+。首次启动约需 10-30 秒,包会将运行时依赖 pip 安装到 ~/.keel/mcpb-lib/py3.X/,之后启动即时完成。该包运行本地 MCP 服务器:助理可组合与校验策略、在真实 Hyperliquid 历史上回测、浏览策略库、比较运行并分享结果。使用 keel_auth_login 登录一次。默认无法下单或转移资金。

首次对话

安装后通过代理登录一次(无需终端命令):

用户:"Connect to Keel." 代理:调用 keel_auth_login。浏览器打开 app.usekeel.io,点击 Allow,令牌写入 ~/.keel/config.yaml。认证有效期 30 天,可透明刷新。

然后描述需求:

用户:"Find me momentum signals for Hyperliquid top-30 perps and compose a backtest from 2024-08-15 to today." 代理:调用 keel_components_search → keel_components_get_many → keel_strategy_compose → keel_backtest_run,返回带完整 tearsheet(净值曲线、Sharpe、最大回撤、各资产归因)的分享 URL。

文档中给出的具体示例:一个资金费率套利回测通过上述流程产生,在真实 Hyperliquid 数据上 2024-08-15 至 2026-04-30 期间 Sharpe 为 2.17。

实盘写入工具

实盘写入工具(keel_live_deploy、keel_live_control、keel_live_update)默认关闭,需通过 KEEL_TOOLSETS 选择启用。即使启用,进入实盘也是交接:keel_live_deploy 不下单,而是返回 Keel Web 应用的链接,由用户选择账户、审阅仓位大小并启动策略。从本机对实盘账户执行操作(keel_live_control 或仅操作员可用的直接部署)还需要本地授权(keel arm live set)。托管连接器 mcp.usekeel.io 完全不包含实盘写入工具。

适用场景

  • 使用 AI 代理在 Hyperliquid 上研究与开发永续合约策略。
  • 在真实历史数据(含资金费率与滑点)上进行确定性回测。
  • 浏览、比较和分享可复制的策略。
  • 在终端、SSH 会话、CI 或脚本中通过 CLI 调用相同能力。

限制与说明

  • 当前为 Alpha 阶段;CLI 与 MCP 表面稳定并定期发布至 PyPI,底层引擎与组件库仍在积极开发。
  • 本地 MCP 默认不能下单或转移资金;实盘操作在 Keel Web 应用中进行。
  • MCPB 包与终端安装路径均要求系统 Python 3.11+。
  • Keel 仅用于度量用户设计的策略,不构成投资建议,回测结果不代表未来收益。
  • 许可证:MIT。

相关链接

  • 网站/产品页:usekeel.io/keel-mcp
  • 文档:usekeel.io/docs/getting-started
  • 代理设置(按宿主):usekeel.io/docs/agents/setup
  • CLI 参考:usekeel.io/docs/sdk/cli-reference
  • MCP 工具参考:usekeel.io/docs/sdk/tool-reference
  • REST API 参考:usekeel.io/docs/api-reference
  • 代理指令(机器可读):AGENTS.md
  • 贡献/报告 bug:见 CONTRIBUTING.md;安全问题请邮件 team@usekeel.io(勿开公开 issue)