适合谁
- 同时使用聚宽与 Ptrade、需要迁移策略的量化交易者
- 希望快速完成常见 API 差异替换并了解剩余手动调整点的开发者
Q
51FMRS · D
这是一个定位清晰的策略迁移工具：基于聚宽与 Ptrade API 的相似性，自动处理导入语句、日志、持仓访问、历史数据等关键差异，并生成带风险标注的转换报告与可直接使用的 .py 文件。功能实用但规则基于模式替换，复杂策略仍需人工复核与回测验证。仓库未提供明确许可证文本（元数据为 NOASSERTION，README 声明 Apache 2.0），使用前请自行确认。
Quant2Ptrader-MCP 是一个基于 Model Context Protocol 的服务器，可将聚宽（JoinQuant）量化策略代码自动转换为 Ptrade 平台格式。它支持直接传入代码或文件路径（.py/.txt/.text/.code/.strategy），自动识别并改写有差异的 API（如导入语句、日志函数、持仓访问、历史数据获取等），生成详细转换报告、标注需手动调整的风险点，并将结果自动保存为 _ptrade.py 文件。服务器由 Xingyu Chen 开发，以 npm 包 quant2ptrader-mcp 发布，支持 stdio 与 HTTP 两种运行模式。
工具能力
convertStrategy
核心转换工具：输入聚宽策略代码或文件路径（可选输出目录），自动转换为 Ptrade 格式并保存为 .py 文件，返回修改详情与兼容性提示。
安装接入
- 克隆仓库并执行 npm install；2. 执行 npm run build 构建；3. 通过 npm run start:stdio（推荐）或 npm run start:http（运行于 http://localhost:3000/mcp）启动；4. 在 Claude Desktop 配置文件（macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.；Windows: %APPDATA%\Claude\claude_desktop_config.）中添加 mcpServers 配置，stdio 模式使用 command: npx, args: ["-y", "quant2ptrader-mcp"]，HTTP 模式使用 type: streamableHttp, url: http://localhost:3000/mcp。
claude_desktop_config.json
{"mcpServers":{"quant2ptrader":{"command":"npx","args":["-y","quant2ptrader-mcp"]}}}
选型与风险
不适合谁
- 需要聚宽研究环境特有 API 或第三方库兼容性保证的用户
- 期望零人工审核直接上实盘的用户
- 非聚宽/Ptrade 平台（如其他量化平台）的策略转换
所需权限
- 读取本地策略文件（.py、.txt、.text、.code、.strategy）
- 在工作目录、原文件目录或指定 output_dir 写入生成的 _ptrade.py 文件
风险与副作用
- order_target_percent 被转为 order_target_value，目标金额需手动计算
- run_weekly/run_monthly 转为 run_daily 后需自行添加日期判断逻辑
- get_fundamentals 查询语法可能需微调；日期时间参数建议用字符串格式
- 聚宽特有研究环境 API 可能无法完全转换；自定义函数和第三方库需手动检查
- 转换结果建议先在 Ptrade 上小规模回测验证，再考虑实盘使用
常见排障
- 确认已执行 npm install 与 npm run build，再启动对应模式
- stdio 模式无法连接时检查 Claude Desktop 配置路径与 JSON 格式
- HTTP 模式确认服务运行于 http://localhost:3000/mcp 且 timeout 设置足够（示例为 600）
- 文件转换失败时检查文件扩展名是否为 .py/.txt/.text/.code/.strategy
- 转换后先核对报告中标注的风险项与代码预览，再运行回测
使用场景
将现有聚宽策略迁移到 Ptrade 平台
批量整理策略文件的 API 差异（导入、日志、持仓、历史数据等）
在 AI 助手中直接以自然语言请求策略转换并获得可运行的 .py 文件
支持客户端
Claude Desktop完整支持