Quant2Ptrader MCP Server

社区

一键将聚宽量化策略转换为Ptrade平台格式的MCP服务器

分类: 开发工具第 243 / 438
Stars: ★ 72 热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js
凭据: 无需凭据
许可证: 其他 / 未声明
最近提交: 11 个月前 ⚠
工具数: 1

51FMRS · D

这是一个定位清晰的策略迁移工具：基于聚宽与 Ptrade API 的相似性，自动处理导入语句、日志、持仓访问、历史数据等关键差异，并生成带风险标注的转换报告与可直接使用的 .py 文件。功能实用但规则基于模式替换，复杂策略仍需人工复核与回测验证。仓库未提供明确许可证文本（元数据为 NOASSERTION，README 声明 Apache 2.0），使用前请自行确认。

最强项 · 文档质量 14/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

9/20

维护活跃度

8/20

文档质量

14/20

安装易用性

12/20

查看各项评分依据

可靠性 8/20: README描述了stdio和HTTP两种启动方式及脚本命令（build/start:stdio/start:http），并给出转换示例，说明基本流程是可信的。但仓库未提供CI工作流或测试套件的证据（仅在README中提到`test_strategy.py`作为示例文件，并非集成测试），也没有MCP初始化/工具列表握手的可验证记录，转换逻辑基于正则匹配，边界情况（如复杂语法、多层调用）的错误处理未见说明。按静态评审规则，缺少可核验的CI+测试证据时可靠性不得超过12分，予以8分。
安全与权限 9/20: 该服务器会读取用户/AI提供的任意文件路径（.py/.txt等）并将转换结果自动写入磁盘（默认原目录或当前工作目录，也可指定output_dir），README中没有提及路径校验、沙箱限制或写入前的用户确认机制，存在潜在的任意文件读写风险。好在该工具不涉及网络凭证、外部API密钥或数据外传，无红线级风险（无删除/支付/远程命令等不可逆默认操作）。因权限边界和确认机制披露不完整，扣分至9分。
维护活跃度 8/20: GitHub仓库元数据显示License为NOASSERTION，但README声称使用Apache License 2.0，两者存在矛盾，反映许可证治理不清晰。仓库有61星、3个未解决issue，但README未提供更新日志、版本发布记录或安全响应渠道（仅有作者邮箱），无法核实维护节奏和依赖更新情况。综合许可证冲突和信息不足，给予8分。
文档质量 14/20: README结构完整，包含安装、构建、stdio/HTTP两种运行模式、Claude Desktop客户端配置示例、多个转换示例、API兼容性对照表、已知问题和未来计划，文档层次较丰富。但缺少工具的正式输入参数schema（如必填/可选字段的精确定义）、错误处理和成本/超时限制的详细说明，故未给满分，评14分。
安装易用性 12/20: 提供了npm install/build的本地运行步骤，以及通过npx直接在Claude Desktop中配置的JSON示例（stdio和HTTP两种模式），步骤清晰、门槛较低。但没有验证性的构建产物或CI证据表明这些步骤当前可用，按静态评审规则未见CI+测试时setup不得超过15分，予以12分。

静态评测 · 未实际运行收录于 2026-09-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件

适合谁

同时使用聚宽与 Ptrade、需要迁移策略的量化交易者
希望快速完成常见 API 差异替换并了解剩余手动调整点的开发者

不适合谁

需要聚宽研究环境特有 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 上小规模回测验证，再考虑实盘使用

安装接入

准备工作

运行环境：Node.js

克隆仓库并执行 npm install
执行 npm run build 构建
通过 npm run start:stdio（推荐）或 npm run start:http（运行于 http://localhost:3000/mcp）启动
在 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"]}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "quant2ptrader": {
      "command": "npx",
      "args": [
        "-y",
        "quant2ptrader-mcp"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add quant2ptrader -- npx -y quant2ptrader-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端的工具列表中应出现 convertStrategy 工具；调用它转换一段包含 from jqdata import * 的策略，若返回的报告中导入语句被改为 from ptrade.api import * 且生成了 *_ptrade.py 文件路径，即说明服务器工作正常。

常见排障

确认已执行 npm install 与 npm run build，再启动对应模式
stdio 模式无法连接时检查 Claude Desktop 配置路径与 JSON 格式
HTTP 模式确认服务运行于 http://localhost:3000/mcp 且 timeout 设置足够（示例为 600）
文件转换失败时检查文件扩展名是否为 .py/.txt/.text/.code/.strategy
转换后先核对报告中标注的风险项与代码预览，再运行回测

试试这样问

连接成功后，可以直接对 AI 助手这样说：

请帮我把这个聚宽策略转换为Ptrade格式：from jqdata import * ...
请将这个聚宽策略文件转换为Ptrade格式，文件路径: /home/user/my_strategy.py
转换这个文件并保存到指定目录，文件: C:\strategies\my_strategy.py，输出目录: D:\ptrade_strategies\
转换 /home/user/my_strategy.txt 这个策略文件并告诉我修改了哪些API

工具能力 1

convertStrategy 写入

核心转换工具：输入聚宽策略代码或文件路径（可选输出目录），自动转换为 Ptrade 格式并保存为 .py 文件，返回修改详情与兼容性提示。

使用场景

将现有聚宽策略迁移到 Ptrade 平台

批量整理策略文件的 API 差异（导入、日志、持仓、历史数据等）

在 AI 助手中直接以自然语言请求策略转换并获得可运行的 .py 文件

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

Quant2Ptrader-MCP 是一个基于 Model Context Protocol 的服务器，可将聚宽（JoinQuant）量化策略代码自动转换为 Ptrade 平台格式。它支持直接传入代码或文件路径（.py/.txt/.text/.code/.strategy），自动识别并改写有差异的 API（如导入语句、日志函数、持仓访问、历史数据获取等），生成详细转换报告、标注需手动调整的风险点，并将结果自动保存为 _ptrade.py 文件。服务器由 Xingyu Chen 开发，以 npm 包 quant2ptrader-mcp 发布，支持 stdio 与 HTTP 两种运行模式。