用途
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)