Keel

keel-trade

Keel 命令行工具和 stdio MCP 服务。
借助你的 AI 助手构建并回测 Hyperliquid 永续期货策略——使用类型化策略组合，并基于真实 Hyperliquid 市场历史数据进行确定性回测。使用真实资金运行策略需在 Keel 网页应用中进行。

网站 · 产品页面 · 文档 · 回测示例 · 讨论

---

什么是 Keel？

Keel 是一个围绕 Hyperliquid 构建的加密货币量化交易平台，提供策略开发、回测、实盘执行和投资组合管理，服务于链上永续合约订单簿深度最大的交易场所。完整平台包括：

• 用于组合策略、运行回测和部署实盘策略的网页应用（app.usekeel.io）
• 确定性回测引擎，使用真实的 Hyperliquid 资金费率、价格和滑点
• 逐位一致的实盘执行——同一编译后的策略产物既用于回测，也用于 Hyperliquid
• 一个包含有文档说明且可分叉交易策略的策略库
• 位于 usekeel.io/lab 的筛选器和计算工具套件（资金费率排行榜、动量、过拟合检查、滚动前向可视化工具等）
• 本软件包 keel-trade——Agent 原生研究界面

此仓库是 keel-trade Python 软件包的公开镜像：只需执行一次 pipx install，即可同时获得命令行工具和 stdio MCP 服务，因此无论从终端还是任何支持 MCP 的 Agent，都可以使用相同的工具。

为什么 Agent 负责创建策略，而不是交易

大多数 Agent 交易项目会将大模型放入执行循环。这会让系统变慢、表现不一致且难以审计。Keel 则采用相反的做法：

You ──── compose ────► Strategy graph ──── compile ────► Deterministic artifact
                              ▲                                    │
                              │                                    ▼
                          Agent edits                          Backtest engine
                          via MCP tools                        (real HL data)
                                                                   │
                                                                   ▼
                                                              Live execution
                                                              (same artifact)

以下三项特性是此设计的核心：

1. **回测与实盘逐位一致。**使用相同的编译产物、引擎和数据路径。不存在可能产生偏差的第二套实现。
2. **采用类型化组合，而非自由形式代码。**策略由版本化组件构成的图组成。编译错误会在编写时捕获问题，而不是等到生产环境中才发现。
3. **Agent 负责组合，确定性引擎负责执行。**Claude / Cursor / Codex 可协助你构建策略，但不会参与交易循环。

快速开始 — 托管 MCP，无需安装

将一个 URL 粘贴到你已在使用的客户端中。你通过客户端自己的 OAuth 流程登录；无需复制 API 密钥，也无需本地安装。

托管端点 URL：https://mcp.usekeel.io/mcp — 一个端点，提供 29 个研究／回测／读取工具，无需安装。登录或注册打开的 Keel 页面（无需提前拥有账号）；身份验证通过 MCP 客户端的 OAuth 流程完成，绝不会通过工具调用完成。

• Claude：自定义 → 连接器 → 添加自定义连接器。粘贴 https://mcp.usekeel.io/mcp，然后选择连接。
• ChatGPT：设置 → 安全与登录 → 开启开发者模式（需要付费 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 会在首次使用时提示你登录。
• 其他：使用客户端自带的“添加远程服务”／HTTP MCP 服务流程，并输入 https://mcp.usekeel.io/mcp。首次请求会返回包含 OAuth 2.1 元数据的 401 响应，因此符合规范的客户端会自行发现登录步骤。

Agent 负责构建、测试和读取。当你想在自己的账户上运行策略时，它会将策略交给 Keel 应用，之后由你继续操作。

设置指南：https://usekeel.io/docs/agents/setup · 各客户端操作手册：https://usekeel.io/agents

还没有 Keel 账号？ 免费创建账号 — 然后连接上方的端点，并让你的 Agent 构建内容。

选择使用方式

Keel 是一款产品，可通过多个入口使用。上方的托管 MCP 是默认方式；此软件包提供 CLI + 本地 MCP 方式。

你是……	默认方式（优先展示）	也可以使用
在网页或手机上使用 Claude／ChatGPT	托管端点 — 粘贴 URL（即将支持目录一键接入）	CLI + 本地 MCP
在 Claude Code／Cursor／终端中工作	托管端点 — 运行一条命令，或粘贴 URL	CLI + 本地 MCP
从 Keel 应用运行策略	Keel 网页应用（连接账号、检查仓位规模，然后在此启动）	各入口均可读取
在未连接交易所账号的情况下尝试策略	模拟运行 — Keel 网页应用，或在 CLI 中运行 keel paper	应用内聊天、本地 MCP
构建自己的 Agent／脚本	SDK + API 密钥	CLI
只浏览／运行策略	网页应用 + 策略库	托管端点

• CLI + 本地 MCP — 此软件包（下方安装）。
• SDK + API 密钥 — 用于构建自己的 Agent 和脚本的 REST API。

各使用方式从零开始完成首次回测的操作手册：usekeel.io/agents。

安装

Claude Desktop — 一键安装（MCPB）

从最新版本下载 keel-trade-<version>.mcpb，然后将其拖到 Claude Desktop 中。这是跨平台的单个安装包，适用于 macOS、Windows 和 Linux。

MCPB 安装包需要系统 Python 3.11+（与下方终端安装方式的前提相同）。首次启动需要约 10-30 秒，因为安装包会通过 pip 将运行时依赖安装到 ~/.keel/mcpb-lib/py3.X/；之后启动即可即时完成。

该安装包运行此软件包的本地 MCP 服务：你的助手可以编写并验证策略、使用真实的 Hyperliquid 历史数据对策略进行回测、浏览策略库、比较运行结果并分享结果。使用 keel_auth_login 登录一次。默认情况下，它无法下单或转移资金——使用真实资金运行策略需要在 Keel Web 应用中进行；除非你启用并在自己的机器上授权，否则用于操作实盘账户的本地工具不会开启（详情见下文）。不想安装任何东西？Claude Desktop 也可以使用快速入门中的托管连接器。

终端 — pipx / uv（Claude Code、Codex、Cursor、Windsurf 等）

pipx install keel-trade

也可以使用 uv tool install keel-trade。需要 Python 3.11+。

然后向你的 Agent 宿主注册 stdio MCP 命令：

# Claude Code
claude mcp add keel -- keel mcp serve

# Codex
codex mcp add keel -- keel mcp serve

有关 Cursor、Windsurf 和通用 MCP 客户端的说明，请参阅 usekeel.io/keel-mcp#install 或 Agent 设置指南。

与 Agent 的首次对话

安装后，通过 Agent 登录一次（无需使用终端命令）：

你： “连接到 Keel。”

Agent： 调用 keel_auth_login。浏览器会打开 app.usekeel.io，你点击“允许”，令牌便会写入 ~/.keel/config.yaml。身份验证有效期为 30 天，并会自动刷新。

然后描述你的需求：

你： “为 Hyperliquid 排名前 30 的永续合约找出动量信号，并编写一项从 2024-08-15 到今天的回测。”

Agent： 依次调用 keel_components_search → keel_components_get_many → keel_strategy_compose → keel_backtest_run。返回一个分享链接，其中包含完整的业绩报告（权益曲线、夏普比率、最大回撤和各资产归因）。

具体示例：这个分享链接展示了通过这一流程生成的资金费率套利回测——使用真实 Hyperliquid 数据，2024-08-15 → 2026-04-30 期间的夏普比率为 2.17。

MCP 提供的功能

默认本地工具集（always、read-only、backtest、share、live-read）涵盖状态、身份验证、组件、策略生命周期、回测、审计、账户、分享和只读实盘监控。

实盘写入工具（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 完全不提供实盘写入工具。

各工具的完整参考文档：usekeel.io/docs/sdk/tool-reference。

CLI 用法

每个 MCP 结果工具都有对应的 CLI 命令。适用于终端、SSH 会话、CI、脚本，或偏好通过子进程调用工具的 Agent：

# Auth + status
keel auth login                      # opens a browser
keel auth login --key "$KEEL_API_KEY"  # CI / SSH / no browser
keel status

# Search components, compose, backtest
keel components search "momentum"
keel strategy compose --source-file my-strategy.py --dry-run
keel backtest run str_abc123 --start-date 2024-08-15 --wait

# Inspect a strategy
keel strategy get str_abc123
keel strategy log str_abc123

CLI 完整参考文档：usekeel.io/docs/sdk/cli-reference。

使用 Keel 可以做什么

任务	入口
回测 Hyperliquid 策略 — 覆盖 HL 永续合约全品种，包含真实手续费、资金费率和滑点，也包括已下架的品种	usekeel.io/hyperliquid-backtest
筛选 HL 永续合约 — 动量、资金费率、成交量、突破、市场状态	usekeel.io/lab
使用 AI 构建策略 — 采用类型化组合，而非自由形式代码	usekeel.io/ai-trading-strategy-builder
回测投资组合，覆盖 HL 全品种	usekeel.io/crypto-portfolio-backtesting
稳健性计算工具 — 滚动前推可视化工具、蒙特卡洛、修正后的夏普比率、过拟合检查	usekeel.io/lab
实时运行策略，通过 Keel Web 应用在你自己的 Hyperliquid 账户上运行（非托管）	usekeel.io/strategy-os
比较策略和交易平台	usekeel.io/compare
浏览有文档说明的交易策略	usekeel.io/strategies

文档

• 产品页面：usekeel.io/keel-mcp
• 入门指南：usekeel.io/docs/getting-started
• Agent 设置（按宿主区分）：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
• Agent 指令（权威、机器可读）：AGENTS.md

状态

Alpha。CLI 和 MCP 接口稳定，并定期发布到 PyPI；底层引擎和组件库仍在积极开发中。

Keel 用于衡量你设计的策略。这不是投资建议，回测结果也不能预测未来收益。

如何贡献／报告错误

请参阅 CONTRIBUTING.md。简而言之：

• 错误报告 → 使用错误模板提交 issue
• 功能请求、问题或模式分享 → 使用 Discussions
• 安全问题 → 发送邮件至 [email protected]（请勿公开提交 issue）
• 补丁 → 欢迎提交 PR；我们在私有单体代码库中维护项目，因此 PR 可能需要更长时间才能合并 — 请参阅 CONTRIBUTING 了解移植流程

相关内容

• Hyperliquid 上的 Keel — 平台
• 什么是 MCP？
• Hyperliquid 上的 AI Agent — 权威指南
• 为什么我们不把大模型放进交易循环

许可证

MIT。请参阅 LICENSE。

---

由 Keel Research Team 打造 · @usekeelio