琴日嗰筆成交咗未
按時間區間翻歷史委託，或者按委託編號查單筆明細，狀態、成交價、數量一次齊。
「我琴日嗰筆 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。各客戶端嘅設定見接入頁。