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 令牌访问
遇到问题？
把截图和客户端版本发给我们，我们会帮你排查。