返回 MCP 目录
public公开dns本地运行

nnquant_qmt-mcp-server

QMT-MCP-Server是一个对接迅投QMT交易系统的服务器应用,通过MCP协议为AI模型提供股票交易能力。

article

README

🚀 QMT-MCP-Server

赋予大模型执行股票交易的能力!QMT-MCP-Server 是一个基于 MCP(模型控制协议)的服务器应用,它能对接迅投 QMT 交易系统,为用户提供股票交易相关的功能接口。

⚠️ 重要提示

本项目仅供交流学习使用,请谨慎用于实盘环境。

✨ 主要特性

  • 账户资产查询:可查询账户的资产情况。
  • 持仓信息查询:能获取持仓的详细信息。
  • 下单:支持进行股票下单操作。
  • 撤单:可对已下的订单进行撤销。

📦 安装指南

前置要求

使用前请先安装 python 包管理工具 uv,安装方法请参考此处

安装步骤

  1. 克隆项目到本地
git clone https://github.com/nnquant/qmt-mcp-server
  1. 安装依赖
uv sync
  1. 运行项目
uv run main.py

📚 详细文档

配置说明

首次运行时,系统会提示输入必要的配置信息:

  • MiniQMT 所在路径
  • 资金账户

配置信息将自动保存在 xttrader.yaml 文件中。

MCP 使用技巧

客户端配置

选择合适的 MCP 客户端,配置好 MCP 服务器。例如在 Cursor 中,配置如下:

{
  "mcpServers": {
    "qmt-mcp-server": {
      "url": "http://localhost:8001/sse"
    }
  }
}

指令案例

  • 请帮我查询我的账户持仓
  • 以 10 元的价格购买 100 股 600000.SH 股票
  • 以 11 元的价格购买 100 股平安银行股票
    • (由于不同大模型的差异,部分情况下可能无法正确转换股票名称到股票代码,使用股票名称下单请谨慎)
  • 以 XX 的价格为我购买 20% 可用仓位的 XXXX 股票
  • 配合其他 MCP 服务完成选股交易的一条龙

注意事项

  • 使用前请确保 MiniQMT 系统正常运行。
  • 交易前请仔细核对账户信息。
  • 所有股票代码需要包含交易所后缀(.SH 或 .SZ)。
  • 本程序仅用于交流和学习,请谨慎用于实盘,本人不承担任何使用者使用本程序所造成的损失。

🔧 技术细节

系统要求

  • Python >= 3.10
  • 开通 QMT 交易权限,且本地已启动 miniqmt
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端