Skip to content
Back to search

QMT-MCP

QMT-MCP 模块化量化交易助手

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/guangxiangdebizi--qmt-mcp/badge.svg)](/listings/guangxiangdebizi--qmt-mcp)

HTML

<a href="/listings/guangxiangdebizi--qmt-mcp"><img src="/api/listings/guangxiangdebizi--qmt-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 396 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # QMT-MCP - 模块化量化交易助手
  2. <div align="center">
  3. ![Version](https://img.shields.io/badge/version-2.0.0-blue.svg)
  4. ![Python](https://img.shields.io/badge/python-3.8+-green.svg)
  5. ![License](https://img.shields.io/badge/license-MIT-yellow.svg)
  6. 一个基于FastMCP和XTQuant的模块化量化交易系统,提供智能策略生成、实时交易执行和回测分析功能。
  7. </div>
  8. ## 🌟 项目特色
  9. - **🔗 MCP协议集成**: 基于Model Context Protocol,与AI助手无缝连接
  10. - **📈 智能策略生成**: 自动生成和优化量化交易策略
  11. - **⚡ 实时交易执行**: 支持XTQuant/QMT实盘和模拟交易
  12. - **🧠 模块化架构**: 清晰的代码结构,易于扩展和维护
  13. - **📊 回测分析**: 完整的策略回测和绩效评估
  14. - **🛡️ 风险控制**: 内置多层风险控制机制
  15. ## 🎬 演示视频
  16. > 📺 点击封面图或链接即可在 Bilibili 观看完整演示
  17. >
  18. > https://www.bilibili.com/video/BV1SFGjz6EKN/?vd_source=26053b834f0ddd4f57b22169d74b6f78
  19. <!-- 如果你准备了演示封面图,可以把下面这行的 docs/demo_cover.png 换成你的图片路径 -->
  20. [![演示视频封面](layout.png)](https://www.bilibili.com/video/BV1SFGjz6EKN/?vd_source=26053b834f0ddd4f57b22169d74b6f78)
  21. ## 🏗️ 系统架构
  22. ```
  23. 国金QMT-MCP/
  24. ├── main.py # FastMCP服务器主入口
  25. ├── config.json # 系统配置文件
  26. ├── requirements.txt # 项目依赖
  27. ├── src/
  28. │ ├── config.py # 配置管理模块(支持环境变量)
  29. │ ├── tools/ # MCP工具实现
  30. │ │ ├── trading_tool.py # 交易执行工具
  31. │ │ └── qmt_tool.py # QMT策略工具
  32. │ ├── strategies/ # 策略模块
  33. │ │ ├── ma_strategy.py # 双均线策略
  34. │ │ └── strategy_generator.py # 策略生成器
  35. │ └── utils/ # 工具模块
  36. │ ├── xtquant_client.py # XTQuant客户端
  37. │ └── data_handler.py # 数据处理器
  38. └── logs/ # 日志文件目录
  39. ```
  40. ## 🚀 快速开始
  41. ### 环境要求
  42. - **Python 3.8+**
  43. - **XTQuant/QMT客户端** (国金/迅投量化交易客户端)
  44. - **Windows系统** (XTQuant仅支持Windows)
  45. ### 安装步骤
  46. 1. **克隆项目**
  47. ```bash
  48. git clone <repository-url>
  49. cd Nondescript-MCP
  50. ```
  51. 2. **安装依赖**
  52. ```bash
  53. pip install -r requirements.txt
  54. ```
  55. 3. **配置环境**
  56. 创建 `.env` 文件并配置以下参数:
  57. ```env
  58. # =====================================================
  59. # 国金QMT-MCP 环境配置文件
  60. # 请根据你的实际环境修改下面的配置参数
  61. # =====================================================
  62. # 服务器配置
  63. QUANTMCP_HOST=127.0.0.1 # MCP服务器监听地址,通常保持127.0.0.1
  64. QUANTMCP_PORT=8000 # MCP服务器端口号,可根据需要修改
  65. QUANTMCP_TRANSPORT=sse # 传输协议,保持sse即可
  66. # XTQuant/QMT 交易客户端配置
  67. # 重要:请修改为你的QMT安装路径和账户信息
  68. QMT_PATH=你的QMT安装路径\userdata_mini # QMT客户端数据目录,如: D:\QMT\userdata_mini
  69. QMT_SESSION_ID=你的会话ID # QMT会话ID,整数,如: 12345
  70. QMT_ACCOUNT_ID=你的交易账户ID # 你的模拟或实盘交易账户ID
  71. # QMT策略保存目录
  72. QMT_STRATEGY_DIR=你的QMT策略目录\mpython # QMT策略文件保存目录,如: D:\QMT\mpython
  73. # 交易风险控制配置
  74. MAX_ORDER_VALUE=100000.0 # 单笔订单最大金额(元),防止误操作大额下单
  75. MAX_POSITION_VALUE=500000.0 # 单只股票最大持仓金额(元),控制单股风险
  76. MIN_ORDER_QUANTITY=100 # 最小下单数量(股),通常为100的整数倍
  77. MARKET_ORDER_SPREAD=0.1 # 市价单价差比例(0.1=10%),避免成交价偏离过大
  78. # 策略默认参数配置
  79. DEFAULT_SYMBOL=000001.SZ # 默认股票代码,用于测试和演示
  80. DEFAULT_START_DATE=20240101 # 默认回测开始日期,格式YYYYMMDD
  81. DEFAULT_END_DATE=20241201 # 默认回测结束日期,格式YYYYMMDD
  82. DEFAULT_SHORT_PERIOD=5 # 默认短期均线天数
  83. DEFAULT_LONG_PERIOD=20 # 默认长期均线天数
  84. # 日志配置
  85. LOG_LEVEL=INFO # 日志级别: DEBUG/INFO/WARNING/ERROR
  86. LOG_FILE=logs/quantmcp.log # 日志文件路径
  87. ```
  88. 4. **启动XTQuant客户端**
  89. - 打开国金QMT或迅投量化客户端
  90. - 确保客户端已登录并连接
  91. 5. **启动国金QMT-MCP服务**
  92. ```bash
  93. python main.py
  94. ```
  95. 服务启动后将在 `http://127.0.0.1:8000` 提供MCP服务。
  96. ## 🔧 功能介绍
  97. ### 交易工具
  98. #### 下单功能
  99. ```python
  100. # 通过MCP接口调用
  101. place_order(
  102. symbol="000001.SZ", # 股票代码
  103. quantity=100, # 买入股数
  104. price=10.5, # 下单价格
  105. direction="BUY" # 交易方向
  106. )
  107. ```
  108. #### 撤单功能
  109. ```python
  110. cancel_order(order_id="12345") # 撤销指定订单
  111. ```
  112. ### 策略生成
  113. #### 双均线策略
  114. ```python
  115. generate_ma_strategy(
  116. symbol="000001.SZ", # 目标股票
  117. short_period=5, # 短期均线
  118. long_period=20, # 长期均线
  119. strategy_name="my_ma" # 策略名称
  120. )
  121. ```
  122. #### 自定义策略
  123. ```python
  124. save_qmt_strategy(
  125. strategy_name="custom_strategy",
  126. code="""
  127. def init(context):
  128. # 策略初始化
  129. pass
  130. def handle_bar(context, bar_dict):
  131. # 策略执行逻辑
  132. pass
  133. """
  134. )
  135. ```
  136. ## 📊 策略回测
  137. 系统提供完整的策略回测功能,包括:
  138. - **收益指标**: 总收益率、年化收益率、夏普比率
  139. - **风险指标**: 最大回撤、波动率、VaR
  140. - **交易统计**: 交易次数、胜率、平均盈亏
  141. - **绩效评估**: 策略评级和优化建议
  142. ### 回测报告示例
  143. ```
  144. [OK] 双均线策略生成成功!
  145. [DATA] 股票信息: 000001.SZ
  146. [DATE] 数据期间: 20240101 至 20241201
  147. [CHART] 数据条数: 242 条
  148. [DATA] 交易天数: 242 天
  149. [TARGET] 双均线策略参数:
  150. * 短期均线: 5日
  151. * 长期均线: 20日
  152. [CHART] 策略表现:
  153. * 总收益率: 15.23%
  154. * 年化收益率: 18.45%
  155. * 最大回撤: -8.67%
  156. * 年化波动率: 22.15%
  157. * 夏普比率: 0.845
  158. * 交易次数: 24
  159. * 胜率: 58.33%
  160. [TIP] 策略评价:
  161. [OK] 年化收益良好,超过15%
  162. [OK] 风险控制优秀,最大回撤小于10%
  163. [WARNING] 夏普比率一般,收益风险比有待提升
  164. [OK] 胜率良好,超过50%
  165. ```
  166. ## 🛡️ 风险控制
  167. 系统内置多层风险控制机制:
  168. ### 交易层面
  169. - 单笔订单最大金额限制
  170. - 单标的最大持仓限制
  171. - 最小下单数量控制
  172. - 市价单价差保护
  173. ### 策略层面
  174. - 最大回撤限制
  175. - 最小夏普比率要求
  176. - 杠杆率控制
  177. - 止损比例设置
  178. ### 系统层面
  179. - 交易状态控制
  180. - 连接状态监控
  181. - 异常处理机制
  182. - 日志记录追踪
  183. ## 🔌 MCP集成
  184. 国金QMT-MCP完全兼容Model Context Protocol,可以与支持MCP的AI助手集成:
  185. ### 首选:SSE 直连配置(推荐)
  186. 如果你只需要**直接连接**到已经启动的国金QMT-MCP服务器,最简洁可靠的方式就是使用 **SSE(Server-Sent Events) 直连**。
  187. ```json
  188. {
  189. "mcpServers": {
  190. "qmt-mcp": {
  191. "type": "sse",
  192. "url": "http://127.0.0.1:8000/sse",
  193. "timeout": 60,
  194. "autoApprove": []
  195. }
  196. }
  197. }
  198. ```
  199. > 📌 **为何推荐 SSE?**
  200. > - 🛠️ **零依赖**:客户端无需再执行 Python/Node 等命令。
  201. > - ⚡ **即开即用**:服务器启动后即可被任何支持MCP的应用发现。
  202. > - 🪶 **配置最少**:仅需 `type` 与 `url` 两个关键字段。
  203. > - 🌐 **远程友好**:修改 `url` 即可在局域网/云服务器访问。
  204. 下面展示不同工具 (Claude Desktop / VS Code Cline / Cursor) 的完整配置示例,如果需要自动拉起服务器也可使用 `command/args` 模式。
  205. ### Claude Desktop集成
  206. 在Claude Desktop的配置文件中添加:
  207. ```json
  208. {
  209. "mcpServers": {
  210. "quantmcp": {
  211. "command": "python",
  212. "args": ["path/to/Nondescript-MCP/main.py"],
  213. "env": {
  214. "QMT_PATH": "你的QMT安装路径\\userdata_mini"
  215. }
  216. }
  217. }
  218. }
  219. ```
  220. ### 可用工具
  221. - `place_order`: 执行股票交易
  222. - `cancel_order`: 撤销订单
  223. - `save_qmt_strategy`: 保存自定义策略
  224. - `generate_ma_strategy`: 生成双均线策略
  225. ## 📋 配置说明
  226. ### 核心配置项
  227. | 配置项 | 说明 | 默认值 |
  228. |--------|------|--------|
  229. | QMT_PATH | QMT客户端安装路径 | 你的QMT安装路径\userdata_mini |
  230. | QMT_SESSION_ID | QMT会话ID | 你的会话ID |
  231. | QMT_ACCOUNT_ID | 交易账户ID | 你的交易账户ID |
  232. | MAX_ORDER_VALUE | 单笔订单最大金额 | 100000.0 |
  233. | MAX_POSITION_VALUE | 单标的最大持仓 | 500000.0 |
  234. ### 策略配置项
  235. | 配置项 | 说明 | 默认值 |
  236. |--------|------|--------|
  237. | DEFAULT_SYMBOL | 默认股票代码 | 000001.SZ |
  238. | DEFAULT_SHORT_PERIOD | 默认短期均线 | 5 |
  239. | DEFAULT_LONG_PERIOD | 默认长期均线 | 20 |
  240. ## 🧪 开发指南
  241. ### 添加新策略
  242. 1. 在 `src/strategies/` 目录下创建策略模块
  243. 2. 实现策略类,包含信号计算和回测方法
  244. 3. 在 `strategy_generator.py` 中注册新策略
  245. 4. 更新配置文件添加策略参数
  246. ### 添加新工具
  247. 1. 在 `src/tools/` 目录下创建工具模块
  248. 2. 实现工具类和相关方法
  249. 3. 在 `main.py` 中使用 `@mcp.tool()` 装饰器注册
  250. 4. 更新 `__init__.py` 文件导出新工具
  251. ### 测试
  252. ```bash
  253. # 运行测试
  254. pytest tests/
  255. # 代码格式化
  256. black src/
  257. # 代码检查
  258. flake8 src/
  259. ```
  260. ## 📚 API文档
  261. ### place_order(symbol, quantity, price, direction)
  262. 执行股票交易订单
  263. **参数:**
  264. - `symbol` (str): 股票代码,如 "000001.SZ"
  265. - `quantity` (int): 交易数量,必须是100的整数倍
  266. - `price` (float): 下单价格
  267. - `direction` (str): 交易方向,"BUY" 或 "SELL"
  268. **返回:**
  269. - `str`: 下单结果信息
  270. ### generate_ma_strategy(symbol, short_period, long_period, strategy_name)
  271. 生成双均线策略
  272. **参数:**
  273. - `symbol` (str): 目标股票代码
  274. - `short_period` (int): 短期均线周期
  275. - `long_period` (int): 长期均线周期
  276. - `strategy_name` (str, optional): 策略名称
  277. **返回:**
  278. - `str`: 策略生成和回测结果
  279. ## 🔍 常见问题
  280. ### Q: XTQuant连接失败怎么办?
  281. A: 确保QMT客户端已启动并登录,检查 `QMT_PATH` 配置是否正确。
  282. ### Q: 如何修改风险控制参数?
  283. A: 在 `.env` 文件中修改 `MAX_ORDER_VALUE`、`MAX_POSITION_VALUE` 等参数。
  284. ### Q: 策略回测数据不准确?
  285. A: 检查数据日期范围,确保XTQuant有相应的历史数据权限。
  286. ### Q: 如何添加新的技术指标?
  287. A: 在 `src/strategies/` 目录下创建新的策略模块,参考 `ma_strategy.py` 的实现。
  288. ## 📄 许可证
  289. 本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件
  290. ## 🤝 贡献
  291. 欢迎提交Issue和Pull Request来改进项目!
  292. ## 📞 联系方式
  293. - 项目地址: https://github.com/guangxiangdebizi/QMT-MCP
  294. - 问题反馈: https://github.com/guangxiangdebizi/QMT-MCP/issues
  295. - 文档: https://github.com/guangxiangdebizi/QMT-MCP/wiki
  296. - 邮箱: guangxiangdebizi@gmail.com
  297. - LinkedIn: https://www.linkedin.com/in/%E6%98%9F%E5%AE%87-%E9%99%88-b5b3b0313/
  298. ---
  299. <div align="center">
  300. **🌟 如果这个项目对你有帮助,请给个Star支持一下! 🌟**
  301. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.