MCP 概覽
11 個工具、兩種接入形態、能力邊界與市場範圍。
更新於 2026-11-04
usmartsg-mcp 面向 uSMART SG OpenAPI 用戶，提供授權、訂單查詢與交易執行三類能力。佢唔提供行情，亦唔解析股票名稱。
兩種接入形態
| 本地 usmartsg-mcp | Claude 連接器 | |
|---|---|---|
| 取得方式 | PyPI，用 uvx 運行 | 自訂連接器 https://openapi.usmartglobal.com/mcp |
| 能力 | 全部 11 個工具，包括落單同改單 | 訂單查詢與落單前預檢 |
| 授權資料喺邊 | 本機 ~/.usmart | uSMART 直接向 Claude 簽發令牌 |
| 適用客戶端 | Claude Code、Cursor、Codex、Kiro | Claude |
能力邊界
| 做 | 唔做 |
|---|---|
| 憑證自檢、OAuth 授權與本地登出 | 行情、K 線、盤口、資訊 |
| 落單前預檢：每手股數、可買賣量、購買力 | 股票名稱解析（代碼與市場由你確認後傳入） |
| 今日與歷史委託、單筆明細 | 出入金、改密碼、綁卡、KYC |
| 落單、改單、撤單（需明確確認） | 遠端 HTTP 服務（本地版預設只行 stdio） |
11 個工具
| 工具 | 類型 | 說明 |
|---|---|---|
| check_trade_credentials | 本地唯讀 | 檢查本地憑證與授權狀態，脫敏輸出 |
| clear_trade_session | 安全操作 | 清除進程內令牌快取 |
| oauth_login | 安全操作 | 發起 OAuth2 授權，回傳授權連結 |
| oauth_login_status | 安全操作 | 查詢或等待授權結果並兌換令牌 |
| oauth_logout | 安全操作 | 刪除本機授權工作階段 |
| preview_order | 上游唯讀 | 每手股數、最大可買賣量、購買力 |
| list_today_orders | 上游唯讀 | 今日委託與成交狀態 |
| list_all_orders | 上游唯讀 | 歷史委託，支援時間區間 |
| get_order_detail | 上游唯讀 | 單筆委託明細 |
| place_order | 寫入操作 | 提交真實委託，需 confirmed=true |
| modify_order | 寫入操作 | 改單或撤單，需 confirmed=true |
市場與區域
- 可交易：港股（0）、美股（5）、滬港通（6）、深港通（7）
- 只可查詢：A 股（67）
- 區域：目前只支援 SG 賬戶，香港協議暫未接入
傳輸
- 本地版預設 stdio，由 MCP 客戶端拉起；授權資料留喺本機
- Claude 連接器係 Streamable HTTP，由 uSMART 託管，用 OAuth Bearer 令牌存取
遇到問題？
把截圖和客戶端版本發給我們，我們會幫你排查。