内容
<p align="center">
<a href="https://usekeel.io/keel-mcp">
<img src="https://usekeel.io/og/keel-mcp.png" alt="keel-trade — 构建、回测和自动执行 Hyperliquid 交易策略，您的代理参与创建，确定性引擎执行" width="100%">
</a>
</p>
<h1 align="center">keel-trade</h1>
<p align="center">
<strong>Keel CLI 和 stdio MCP 服务器。</strong><br>
构建、回测和自动执行 <a href="https://hyperliquid.xyz">Hyperliquid</a> 交易策略，您的代理参与创建，确定性引擎执行。
</p>
<p align="center">
<a href="https://pypi.org/project/keel-trade/"><img src="https://img.shields.io/pypi/v/keel-trade.svg" alt="PyPI 版本"></a>
<a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.11+-blue.svg" alt="Python 3.11+"></a>
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green.svg" alt="MIT 许可证"></a>
<a href="https://usekeel.io/keel-mcp"><img src="https://img.shields.io/badge/product-keel--mcp-635BFF.svg" alt="产品页面"></a>
<a href="https://glama.ai/mcp/servers/keel-trade/keel-trade"><img src="https://glama.ai/mcp/servers/keel-trade/keel-trade/badges/score.svg" alt="keel-trade MCP 服务器"></a>
</p>
<p align="center">
<a href="https://usekeel.io">官网</a> ·
<a href="https://usekeel.io/keel-mcp">产品页面</a> ·
<a href="https://usekeel.io/docs">文档</a> ·
<a href="https://app.usekeel.io/share/gDXjURKqWPs8CZ4eXdqAI?ref=H0O2KN">回测示例</a> ·
<a href="https://github.com/keel-trade/keel-trade/discussions">讨论</a>
</p>
---
## 什么是 Keel？
[Keel](https://usekeel.io) 是一个围绕 Hyperliquid 的量化加密货币交易平台，提供策略开发、回测、实时执行和投资组合管理等功能。平台包括：
- **网页应用**：用于策略编写、回测和部署实时交易（[app.usekeel.io](https://app.usekeel.io)）
- **确定性回测引擎**：具有真实的 Hyperliquid 资金 + 价格 + 滑点， walk-forward 和 Monte Carlo
- **比特级实时执行**：相同的编译策略产物在回测和 Hyperliquid 上执行
- **策略库**：文档齐全、可 fork 的交易策略
- **筛选器 + 计算器套件**：在 [usekeel.io/lab](https://usekeel.io/lab)（资金排行榜、动量、超额检查、walk-forward 可视化等）
- **此软件包** — `keel-trade` — **代理原生研究界面**
本仓库是 `keel-trade` Python 软件包的公共镜像：单个 `pipx install` 命令可同时提供 CLI 和 stdio MCP 服务器，因此相同的工具可从终端或任何支持 MCP 的代理使用。
## 为什么代理创建策略，而不是交易它们？
大多数代理交易项目将 LLM 放在执行循环中。这使得系统变慢、不一致且难以审计。Keel 则相反：
```
您 ──── 编写 ────► 策略图 ──── 编译 ────► 确定性产物
▲ │
│ ▼
代理编辑 回测引擎
通过 MCP 工具 （真实 HL 数据）
│
▼
实时执行
（相同的产物）
```
三个属性驱动了设计：
1. **回测和实时比特级一致性**：相同的编译产物、相同的引擎、相同的数据路径。没有可能漂移的第二个实现。
2. **类型化组合而非自由代码**：策略是版本化组件的图。编译错误在作者阶段捕获 bug，而不是在生产中。
3. **代理编写，确定性引擎执行**：Claude / Cursor / Codex 帮助您构建策略。它们不在交易循环中。
## 安装
### Claude Desktop — 一键安装（MCPB）
从 [最新版本](https://github.com/keel-trade/keel-trade/releases/latest) 下载 `keel-trade-<version>.mcpb` 并拖放到 Claude Desktop 上。跨平台单 bundle — 适用于 macOS、Windows 和 Linux。
MCPB bundle 需要系统 Python 3.11+（与终端安装路径相同）。首次启动需要 ~10-30 秒来 pip-install 运行时依赖到 `~/.keel/mcpb-lib/py3.X/`；后续启动是即时的。
### 终端 — pipx / uv（Claude Code、Codex、Cursor、Windsurf 等）
```bash
pipx install keel-trade
```
`uv tool install keel-trade` 也可以。Python 3.11+。
然后在您的代理主机上注册 stdio MCP 命令：
```bash
# 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](https://usekeel.io/keel-mcp#install) 或 [代理设置指南](https://usekeel.io/docs/sdk/agent-setup)。
## 与您的代理的第一次对话
安装后，通过代理登录一次（无需终端命令）：
> **您：** _“连接到 Keel。”_
>
> **代理：** _调用 `keel_auth_login`。浏览器打开到 app.usekeel.io，您点击允许，令牌出现在 `~/.keel/config.yaml` 中。认证有效期为 30 天，刷新令牌透明。_
然后描述您想要的：
> **您：** _“为 Hyperliquid 前 30 名 perps 找到动量信号，并从 2024-08-15 到今天创建一个回测。”_
>
> **代理：** _调用 `keel_components_search` → `keel_components_detail_batch` → `keel_strategy_compose` → `keel_backtest_run`。返回一个包含完整报告（权益曲线、夏普比率、最大回撤、每项资产归因）的共享 URL。_
具体示例：[此共享 URL](https://app.usekeel.io/share/gDXjURKqWPs8CZ4eXdqAI?ref=H0O2KN) 是通过此流程生成的资金携带回测，在 2024-08-15 → 2026-04-30 上获得了 2.17 的夏普比率，使用真实的 Hyperliquid 数据。
## MCP 公开的内容
默认工具集涵盖状态、身份验证、组件、策略生命周期、回测、审计、账户、共享和只读实时监控。**实时写入工具**（`keel_live_deploy`、`keel_live_control`）需要明确选择工具集和本地授权步骤 — 代理在未经您两次授权的情况下无法部署您的账户。
完整的工具参考：[usekeel.io/docs/sdk/tool-reference](https://usekeel.io/docs/sdk/tool-reference)。
## CLI 用法
每个 MCP 结果工具都有一个 CLI 镜像。适用于终端、SSH 会话、CI、脚本或更喜欢子进程调用的代理：
```bash
# 身份验证 + 状态
keel auth login
keel status
# 搜索组件、编写、回测
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
# 检查策略
keel strategy get str_abc123
keel strategy log str_abc123
```
完整的 CLI 参考：[usekeel.io/docs/sdk/cli-reference](https://usekeel.io/docs/sdk/cli-reference)。
## 您可以用 Keel 做什么
| 任务 | 界面 |
| ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ |
| **回测 Hyperliquid 策略** — 真实费用、资金、滑点、~220 perps | [usekeel.io/hyperliquid-backtest](https://usekeel.io/hyperliquid-backtest) |
| **筛选 HL perps** — 动量、资金、交易量、突破、状态 | [usekeel.io/lab](https://usekeel.io/lab) |
| **使用 AI 构建策略** — 类型化组合，而非自由代码 | [usekeel.io/ai-trading-strategy-builder](https://usekeel.io/ai-trading-strategy-builder) |
| **回测投资组合** 跨 HL 宇宙 | [usekeel.io/crypto-portfolio-backtesting](https://usekeel.io/crypto-portfolio-backtesting) |
| **稳健性诊断** — walk-forward、Monte Carlo、降低夏普比率、PBO | [usekeel.io/hyperliquid](https://usekeel.io/hyperliquid) |
| **在 Hyperliquid 上部署策略** （非托管） | [usekeel.io/strategy-os](https://usekeel.io/strategy-os) |
| **比较策略 + 场所** | [usekeel.io/compare](https://usekeel.io/compare) |
| **浏览记录的交易策略** | [usekeel.io/strategies](https://usekeel.io/strategies) |
## 文档
- **产品页面**：[usekeel.io/keel-mcp](https://usekeel.io/keel-mcp)
- **快速入门**：[usekeel.io/docs/getting-started](https://usekeel.io/docs/getting-started)
- **代理设置（每个主机）**：[usekeel.io/docs/sdk/agent-setup](https://usekeel.io/docs/sdk/agent-setup)
- **CLI 参考**：[usekeel.io/docs/sdk/cli-reference](https://usekeel.io/docs/sdk/cli-reference)
- **MCP 工具参考**：[usekeel.io/docs/sdk/tool-reference](https://usekeel.io/docs/sdk/tool-reference)
- **REST API 参考**：[usekeel.io/docs/api-reference](https://usekeel.io/docs/api-reference)
- **代理说明**（规范、可读）：[`AGENTS.md`](AGENTS.md)
## 状态
Alpha。CLI 和 MCP 界面稳定，定期发布到 PyPI；底层引擎和组件库正在积极开发中。
## 如何贡献 / 报告错误
参见 [`CONTRIBUTING.md`](CONTRIBUTING.md)。简要说明：
- **错误报告** → 使用错误模板打开问题
- **功能请求、问题或模式共享** → 使用 [讨论](https://github.com/keel-trade/keel-trade/discussions)
- **安全问题** → 发送电子邮件至 `team@usekeel.io`（不要公开问题）
- **补丁** → 欢迎 PR；我们维护私有 monorepo，因此 PR 可能需要更长时间才能实施 — 参见 CONTRIBUTING 以获取移植过程
## 相关
- [Keel on Hyperliquid — 平台](https://usekeel.io)
- [什么是 MCP？](https://usekeel.io/learn/what-is-mcp)
- [Hyperliquid 上的 AI 代理 — 权威指南](https://usekeel.io/agent/hyperliquid)
- [为什么我们不将 LLM 放在交易循环中](https://usekeel.io/learn/agentic-trading)
## 许可证
MIT。参见 [`LICENSE`](LICENSE)。
---
<p align="center">
由 <a href="https://usekeel.io/about">Keel 研究团队</a> · <a href="https://x.com/usekeelio">@usekeelio</a> 构建
</p>
