
AKQuant
io.github.akfamilyPublished by GitHub account akfamilyv0.3.82Updated Nov 7, 2026
Write and backtest trading strategies with AKQuant: API lookup, strategy checks, backtest runs
Overview
AKQuant's MCP server lets an assistant look up the AKQuant API, write and check trading strategies, and run backtests, returning structured results and errors.
- What you can do
- Look up AKQuant API references for writing strategy code
- Write and validate trading strategies inside a project directory
- Run backtests and read structured results and error reports
- Work alongside a market-data MCP server so the assistant can fetch data, write a strategy and interpret the outcome
- When to use it
- Useful when you want to develop and backtest quantitative trading strategies in natural language from an AI assistant, for example running a moving-average crossover on A-share daily data and reporting return and maximum drawdown.
- Requirements
- Runs locally over stdio via uvx from the akquant[mcp] package, so uv must be installed; a project directory passed with --root must exist beforehand. No authentication, environment variables or headers are declared. Data retrieval typically relies on a separate market-data MCP server such as AKShare's.
Installation
In SourceWeft
- Open AKQuant in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
[PyPI Version] [Python Versions] [License] [AKShare] [Downloads]
AKQuant 是一款专为量化投研设计的下一代高性能混合框架。核心引擎采用 Rust 编写以确保极致的执行效率,同时提供优雅的 Python 接口以维持灵活的策略开发体验。
🚀 核心亮点:
- 高性能内核:得益于 Rust 的零开销抽象与 Zero-Copy 数据导入(
add_arrays借用 NumPy 缓冲入引擎;策略侧get_history等读取则返回安全快照拷贝),AKQuant 在部分回测场景下可显著降低 Python 层开销;实际运行速度取决于策略逻辑、数据规模、回调频率与运行环境。 - 原生 ML 支持:内置 Walk-forward Validation(滚动训练)框架,无缝集成 PyTorch/Scikit-learn,让 AI 策略开发从实验到回测一气呵成。
- TA-Lib 指标生态:内置
akquant.talib双后端(python/rust)兼容能力,支持 104 个指标。 - 因子表达式引擎:内置 Polars 驱动的高性能因子计算引擎,支持
Rank(Ts_Mean(Close, 5))等 Alpha101 风格公式,自动处理并行计算与数据对齐。 - 参数优化:内置多进程网格搜索(Grid Search)框架,支持策略参数的高效并行优化。
- 专业级风控:内置完善的订单流管理与即时风控模块,支持多资产组合回测。
- AI 助手(MCP):自带 MCP 服务,在 WorkBuddy、DeepSeek Harness、Codex、Cursor、Claude 等 AI 助手中用自然语言写策略、跑回测,助手能读到结构化的结果和报错;已上架 MCP 官方注册表(
io.github.akfamily/akquant)。
👉 阅读完整文档 | English Documentation
安装说明
AKQuant 已发布至 PyPI,无需安装 Rust 环境即可直接使用。
在 AI 助手中使用(MCP)
先安装 uv,然后在 WorkBuddy、DeepSeek Harness、Codex、Claude Code 等 AI 助手中说一句话就能装好:
安装 AKShare 和 AKQuant 的官方 MCP,项目目录用 /path/to/akquant-demo,运行一个示例策略并报告结果
助手会自己配置好两个服务,再下载数据、编写策略、运行回测并解读结果,不需要事先安装 AKQuant。助手没能自动安装,或者想手动配置时,--root 是项目目录(请先建好),策略和数据文件都放在里面:
WorkBuddy、Cursor、Claude Desktop 等使用 JSON 配置的客户端:
DeepSeek Harness 不读 JSON,要把同样的命令写进 ~/.dsh/profiles/web/cordis.patch.yml,写法见 MCP 服务文档。
接入后可以直接说“用平安银行近三年的日线跑一个均线交叉策略,报告收益和最大回撤”。和 AKTools(AKShare 的官方 MCP)一起接入,助手可以自己查数据、写策略、跑回测。各客户端的配置、工具清单与注意事项见 MCP 服务文档。
快速开始
以下是一个简单的策略示例:
调用 result.viz.report(..., benchmark=...) 后,报告会新增“基准对比 (Benchmark Comparison)”区块,展示策略/基准/超额累计收益曲线,以及累计超额收益、年化超额收益、跟踪误差、信息比率、Beta、Alpha 等相对指标。
注意:
run_backtest默认不计交易成本、不开 T+1。 不传broker_profile也不传费率时,佣金、印花税、过户费都是 0,可以当日买卖,最小交易单位是 1 股——这样得到的是理想化的结果,换手越高越偏乐观。A 股回测请像上面这样传broker_profile(内置cn_stock_miniqmt、cn_stock_t1_low_fee、cn_stock_sim_high_slippage),或者显式传commission_rate、stamp_tax_rate、transfer_fee_rate、min_commission、t_plus_one=True、lot_size=100。模板的印花税按 2023-08-28 起的现行税率 0.05% 计,回测此前的行情请显式传stamp_tax_rate=0.001。
运行结果示例:
复杂订单助手 (OCO / Bracket)
AKQuant 提供了两组复杂订单助手,减少手写订单联动逻辑:
place_oco(first_order_id, second_order_id, group_id=None):将两个订单绑定为 OCO,任一成交后自动撤销另一单。place_bracket(symbol, quantity, entry_price=None, stop_trigger_price=None, take_profit_price=None, ...):一次性提交 Bracket 结构;进场成交后自动挂出止损/止盈,并在双退出单场景下自动绑定 OCO。
可直接运行完整示例:
流式回测 (Streaming)
如果你希望在回测执行过程中实时消费事件,可直接使用 run_backtest 并传入 on_event:
on_event 为可选参数:不传时保持传统阻塞语义,传入时可实时消费事件。
关键参数:
stream_progress_interval/stream_equity_interval: 进度与权益事件采样间隔stream_batch_size/stream_max_buffer: 缓冲与批量刷新控制stream_error_mode: 回调异常策略,支持"continue"与"fail_fast"
可视化 (Visualization)
AKQuant 内置了基于 Plotly 的强大可视化模块,仅需一行代码即可生成包含权益曲线、回撤分析、月度热力图等详细指标的交互式 HTML 报告。
你也可以直接复用结构化分析结果做二次研究:
[Strategy Dashboard]
👉 点击查看交互式报表示例 (Interactive Demo)
文档索引
- 📖 核心特性与架构: 了解 AKQuant 的设计理念与性能优势。
- 🛠️ 安装指南: 详细的安装步骤(含源码编译)。
- 🚀 快速入门: 更多示例与基础用法。
- 🤖 机器学习指南: 如何使用内置的 ML 框架进行滚动训练。
- 📚 API 参考: 详细的类与函数文档。
- 🧩 MCP 服务: 让 WorkBuddy、DeepSeek Harness、Codex、Cursor、Claude 等 AI 助手查 API、写策略、跑回测、读结构化报错。
- 💻 贡献指南: 如何参与项目开发。
🧪 测试与质量保证
AKQuant 采用严格的测试流程以确保回测引擎的准确性:
- 单元测试: 覆盖核心 Rust 组件与 Python 接口。
- 黄金测试 (Golden Tests): 使用合成数据验证关键业务逻辑(如 T+1、涨跌停、保证金、期权希腊值),并与锁定的基线结果进行比对,防止算法回退。
运行测试:
Citation
Please use this bibtex if you want to cite this repository in your publications:
License
MIT License
Source: README.md at commit 162e56f
Tools
0Version history
1- v0.3.82LatestNov 7, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts