昨天那笔成交了吗
按时间区间翻历史委托，或按委托编号查单笔明细，状态、成交价、数量一次给全。
「我昨天那笔 00700 的买单成交了吗？」
已发布 · PyPI usmartsg-mcp 1.1.0 · Apache-2.0 开源
用大白话下单，
每一笔都要你点头。
usmartsg-mcp 把 uSMART 的下单、改单与订单查询接进 Claude Code、Cursor、Codex 等 MCP 客户端。装好就是全部 11 个工具。凭证只留在你电脑上，不经过模型；每笔下单、改单都要你显式确认。
接入 Claude CodePython 3.10+ · uv
claude mcp add usmart -- uvx --from usmartsg-mcp==1.1.0 usmartsg-mcp支持港股、美股与沪深港通，当前仅限 SG 区域
连接器尚未开放，以下为开放后的流程
添加连接器 · uSMART
→浏览器打开 uSMART 授权页…
✓已授权 · 账户 #8821
✓已连接 · 查询与预检
我想买 100 股 00700，够钱吗？顺便看看今天有没有已经挂着的单
preview_order00700 · 港股 · 限价 380
list_today_orders00700 · 港股
✓ 2 个工具返回 · 640ms
购买力 HK$128,400，每手 100 股；按 HK$380 算，100 股约 HK$38,000，够。
今天没有 00700 的挂单。要我提交 100 股、限价 HK$380 的委托吗？提交前需要你确认。
可用工具11
本次耗时640ms
下单须确认
11 个工具默认全部可用，每笔下单都会先让你确认。
支持 MCP 的客户端都能接入
- ChatGPT
- Claude
- Claude Code
- Cursor
- Codex
- Kiro
- 0
- 个工具，授权 / 查询 / 交易
- 0
- 个写操作，每笔都要你确认
- 0
- 份凭证进入模型上下文
- 0
- 道闸：显式确认、整手预检、审计、不重试
快速开始
三步接入，装好就能用。
不需要行情权限，也不需要自己写交易接口。有 uSMART 账户和 OpenAPI 权限就能开始。
- 01
确认账户与环境
有已开户并开通 SG OpenAPI 权限的 uSMART 账户，本机装好 Python 3.10+ 与 uv。不需要自己申请 App ID，也不需要 App Secret。
Python 3.10+ · uv - 02
一行命令加进客户端
用 uvx 把 usmartsg-mcp 加进 Claude Code、Cursor、Codex 或 Kiro。11 个工具默认全部可用，首次运行自动生成 OAuth2 配置，不用手写 JSON。
uvx --from usmartsg-mcp - 03
授权，再查一次订单
调用 oauth_login 在浏览器用 uSMART 账户授权，再用 check_trade_credentials 与 list_today_orders 确认链路，之后就可以下单。
oauth_login → list_today_orders
使用场景
三件它现在就能替你做的事
每个用法都对应一个真实工具，结果可以直接拿去核对，不靠模型复述。
下单前先算够不够钱
预检返回每手股数、最大可买卖量与购买力；不是整手数量会直接拒绝并给出建议。
「买 2 手 00700 大概要多少钱？我够吗？」
把挂着的单撤掉
改单与撤单同样要你先确认，并写入本机审计流水。
「把 00700 那张 380 的买单撤了。」
对话示例
不是让 AI 猜，是让它去查你的委托。
每次调用都能看到工具名与耗时。写操作要过确认、整手预检与审计，而且绝不自动重试。
- 下单前先预检，整手算错直接拒绝
- 写操作不自动重试，结果未知转人工核验
- 所有写操作写入本机 JSONL 审计
uSMART MCP · session 4f21帮我把 00700 那张 380 的买单撤了，顺便看看今天还剩哪些没成交。
list_today_orders180 ms
get_order_detail210 ms
找到这一笔：00700 买入 100 股 @ 380，委托编号 88231409，未成交。确认撤销吗？
确认。
modify_order260 ms
今天还有 2 笔未成交：00700 买入 100 股 @ 380，AAPL 卖出 20 股 @ 215。00700 的撤单已提交，委托编号 88231409——已受理不等于已撤销，稍后用 list_today_orders 复核即可。
安全
授权可控，下单可控。
本地模式下，MCP 用的是你机器上的凭证和 uSMART 的授权，不是交给 AI 的密码。
凭证不出本机
OAuth 会话与可选的交易密码只存在 ~/.usmart，工具参数和模型上下文里都不会出现。
工具全开，不自动批准
装好即注册全部 11 个工具，包括下单与改单。请不要把交易工具加进客户端的自动批准列表，这样每次调用都会先问你。
写操作要确认
每笔委托必须 confirmed=true，并通过整手预检。服务端不设金额或笔数限额，请自行核对每一笔。
审计与不重试
写操作落本机 JSONL 审计；超时或鉴权失败一律转人工，不做第二次。
任何 AI 都可能误解你的意图。下单前请自行核对标的、方向、数量与价格；已受理不等于已成交。
| 能力 | 说明 | 工具 |
|---|---|---|
| 授权与凭证 | OAuth2 授权、令牌刷新、本地登出与凭证自检。密码与令牌从不进入模型上下文。 | oauth_login oauth_login_status check_trade_credentials |
| 订单查询 | 今日与历史委托、单笔明细，以及下单前预检：每手股数、可买卖量、购买力。 | preview_order list_today_orders get_order_detail |
| 交易执行 | 下单、改单、撤单，装好默认可用。必须显式确认，经整手预检与本地审计，失败绝不重试。 | place_order modify_order |
客户端
六个客户端，两种接法
Claude 通过自定义连接器接入，不用装 Python，只做查询与预检；ChatGPT 连接器即将开放。本地客户端用 uvx 运行 usmartsg-mcp，全部 11 个工具默认可用，下单也在这里。
ChatGPT 连接器的开放时间跟随平台审核进度。
对比
两种用法，按需要选。
同一套工具，两种接入方式。日常查询用连接器，真正下单回到本地客户端。
| ChatGPT / Claude | 本地客户端 | |
|---|---|---|
| 适合 | 日常查询与预检 | 需要在对话里下单 |
| 能做什么 | 查询 + 预检 | 全部 11 个工具 |
| 凭证在哪 | 经授权访问 | 本机 ~/.usmart |
| 上线状态 | Claude 已上线，ChatGPT 即将开放 | 已发布到 PyPI |
| 前提 | uSMART 账户与 OpenAPI 权限 | Python 3.10+ 与 uv |
连接器目前只做查询与预检，下单留在本地客户端。
已发布
本地版 usmartsg-mcp
已发布到 PyPI（Apache-2.0）：OAuth2 授权、订单查询、下单前预检与下单，11 个工具默认全部可用。
已上线
Claude 连接器
claude.ai 自定义连接器已上线，浏览器授权后即可查询订单、做下单前预检。
下一步
ChatGPT 连接器
平台审核通过后开放订单查询与下单前预检。
规划中
更多市场
新加坡之外的区域适配，取决于当地协议与监管。
常见问题
常见问题
装好 Python 3.10+ 与 uv 后，由 MCP 客户端用 uvx --from usmartsg-mcp==1.1.0 usmartsg-mcp 拉起即可，也可以 pip install usmartsg-mcp==1.1.0。各客户端的配置见接入页。