qmt

QMT-MCP-Server 提供对接迅投 QMT 交易系统的能力，基于 MCP（Model Control Protocol）规范实现股票交易相关的接口。通过将服务器注册到 MCP 客户端（如 Cursor 等）并指向本地 http 服务端点，外部大模型或工具可以发出账户查询、持仓查询、下单和撤单等指令。核心功能包括：查询账户资产、查询持仓信息、下单委托、撤单处理。使用前请确保 MiniQMT 已正常运行并且本地交易权限已开启。通过 MCP 客户端的配置，将 qmt-mcp-server 的 url 指向本地服务的端点，例如 http://localhost:8001/sse，以实现指令与响应的交互。使用时，用户可以直接用自然语言指令示例来触发操作，例如查询账户资产、查询特定股票的持仓、以给定价格和数量进行买入/卖出等，系统会将其转换为相应的交易接口调用并返回执行结果。请注意，股票名称到代码的映射可能存在不确定性，实际下单请尽量使用带交易所后缀的股票代码（如 600000.SH、000001.SZ）。

Prerequisites:

• Python 3.10 or higher
• 已安装 MiniQMT 并确保本地交易权限已开启
• Python 包管理工具 uv（uvx 在本项目的使用场景中可通过 uvx 命令执行）

Install steps:

1. 克隆仓库：

git clone https://github.com/nnquant/qmt-mcp-server

2. 安装并配置 uv/uvx（按官方文档安装 UV：https://docs.astral.sh/uv/getting-started/installation/）
3. 进入项目目录并启动服务：

uv run main.py

4. 检查日志，确保 MiniQMT 可以通过本地路径访问，且账户信息配置已保存（首次运行系统会提示配置必要信息，保存位置为 xttrader.yaml）。

注：确保 MiniQMT 系统正在运行且本地网络无阻塞，MCP 服务端口通常为默认或配置项中的端口，具体以运行输出为准。

Tips and common issues:

• 如首次运行，系统会提示配置 MiniQMT 路径和资金账户，配置完成后保存在 xttrader.yaml。
• 确保 MiniQMT 系统正常运行，交易前再次核对账户信息。
• 所有股票代码需包含交易所后缀（.SH 或 .SZ），避免下单失败。
• 对于名称到代码的映射，存在不确定性时优先使用明确的股票代码。
• MCP 服务端与 MiniQMT 的网络连通性、权限设置，以及防火墙配置都会影响功能可用性，请确保相应端口对外暴露并允许访问。
• 若遇到下单失败，查看日志输出的响应码和错误信息，以便定位到交易权限、账户余额或风控等问题。