Longbridge
官方美股/港股市場 — 110 項工具:即時報價、期權、訂單、基本面、提醒、DCA 及投資組合
你可以用 Longbridge MCP 做什麼?
- 即時報價 — 查詢美國和香港市場的即時與歷史報價、K 線、深度資料和期權資料。
- 投資組合與交易 — 檢視持倉、餘額和成交紀錄,或提交、取消及修改訂單,包括多腿期權組合。
- 基本面與研究 — 查詢股票的財務報表、股息、分析師觀點、估值和公司高層資料。
- 篩選與日曆 — 執行股票篩選搜尋,或查看財經日曆中的業績、股息、IPO 和宏觀經濟數據。
- 提醒與定期計劃 — 建立價格提醒、管理定期定額計劃,並設定網格交易策略。
- 篩選回應 — 將
_jq表達式傳遞給任何工具,將大型回應精簡為所需欄位。
託管 MCP 伺服器
npx add-mcp 'https://mcp.longbridge.com'可安裝到 Claude Code、Codex、Cursor 等客戶端
文件
Longbridge MCP Server
適用於 Longbridge 券商的官方 MCP 伺服器。提供 164 個工具,涵蓋即時報價、選擇權、訂單路由、基本面、分析師評級、日曆、IPO、價格提醒、定期定額計畫、網格交易、投資組合分析及社群自選清單,支援美國及香港市場。使用 Rust 搭配 rmcp 和 axum 建置。
現已在 ChatGPT 和 Claude 上線
Longbridge 已正式列入 ChatGPT Apps 目錄和 Claude Connectors 目錄。
以日常語言與市場互動——查詢報價、選擇權、基本面及您自己的投資組合——
無需編輯設定檔,也不必貼上權杖。
| 在一處新增 | 然後直接詢問 | |
|---|---|---|
| ChatGPT | Settings → Apps & Connectors → 新增 Longbridge | 「NVDA 今天的交易情況如何?」 · 「顯示我的香港持倉」 |
| Claude | Settings → Connectors → 新增 Longbridge(網頁版 · 桌面版 · 行動版) | 「比較 AAPL 和 MSFT 的估值」 · 「本週有 IPO 嗎?」 |
使用您的 Longbridge 帳戶登入一次即可。每個請求都會透過下方文件所述、採用 OAuth 2.1 保護的同一個託管端點執行——提供唯讀市場資料,以及完整的帳戶、投資組合和交易工具,並由您自己的憑證控管存取權限。
特色
- 164 個工具,一個端點 — 涵蓋美國及香港市場的報價、選擇權、訂單路由、基本面、分析師研究、篩選器、IPO、提醒、定期定額、網格交易及投資組合分析。
- 採用無狀態設計 — 每個請求都會將 Bearer 權杖直接轉送至 Longbridge SDK。不使用工作階段、不使用資料庫,伺服器端也不儲存任何資料。
- 自動探索 OAuth 2.1 — 提供 RFC 9728 受保護資源和 RFC 8414 授權伺服器中繼資料;用戶端無需貼上權杖即可完成流程。
- 清晰、具型別的回應 — 使用 snake_case 欄位、RFC 3339 時間戳記、易讀的代號,並透過 MCP 資源提供具型別的回應結構描述。
使用 jq 篩選工具回應
每個工具的引數都接受選填的 _jq 字串。此運算式會在一般回應序列化完成後,
套用至完整的回傳 JSON。_jq
名稱保留供回應篩選使用,以避免與業務參數衝突。
使用指引會在 MCP initialize 回應的 instructions 中傳送一次;
每個工具結構描述只會宣告選填參數的名稱和型別。
例如:
{
"name": "quote",
"arguments": {
"symbols": ["AAPL.US", "MSFT.US"],
"_jq": "map({symbol, last_done})"
}
}
使用 .data[:5] 取得 data 陣列的前五個項目,
使用 .data | map(select(.price > 10)) 選取資料列,或使用 {total: .total} 投影欄位。
運算式採用內嵌 jaq 引擎相容於 jq 的語法;不需要另外安裝
jq 可執行檔。
- 省略
_jq(或傳入null)即可保留原始回應。 - 若只有一個輸出值,會直接回傳;若有多個值,則以陣列回傳;若沒有值,則回傳
[]。純量和陣列會以 JSON 文字呈現;物件也會出現在structuredContent中,且只包含篩選後的欄位。 - 純文字回應會以 JSON 字串提供。沒有結構化內容的多個內容區塊會以陣列提供。
- 工具錯誤及權限/無資料說明不會經過篩選。
- 空白、無效或非字串運算式會在工具執行前遭到拒絕。若執行期間篩選失敗,回應會明確指出工具已執行。請勿自動重試下單等寫入操作。
- 無法使用環境存取、檔案系統匯入及記錄篩選器。輸出上限為 10,000 個值及 8 MiB;超過上限時會回傳錯誤,而非部分結果。
由於篩選器可能改變回應形狀,工具不會宣告固定的
outputSchema。原始具型別的結構描述仍可透過 resources/list
和 resources/read 在 lb://tools/{tool-name}/output-schema 取得,適用於有結構描述的工具。
連接您自己的用戶端
Longbridge 提供託管端點 https://mcp.longbridge.com — 將任何 MCP 用戶端指向此端點,並在提示時完成 OAuth。授權會透過 RFC 9728 自動探索;無需貼上權杖。
Claude Code
claude mcp add --transport http longbridge https://mcp.longbridge.com
Claude Desktop — 將設定新增至 claude_desktop_config.json,然後重新啟動:
{ "mcpServers": { "longbridge": { "url": "https://mcp.longbridge.com" } } }
Codex — 新增伺服器,然後在瀏覽器中完成 OAuth:
codex mcp add longbridge --url https://mcp.longbridge.com
codex mcp login longbridge
Cursor · Cline · Windsurf · Zed · 其他用戶端 — 將它們指向 https://mcp.longbridge.com,並使用傳輸方式 streamable-http。
更多 Claude Code 指令
# Local self-hosted instance (see Self-hosting below)
claude mcp add --transport http longbridge-local http://localhost:8000/mcp
claude mcp list # registered servers
claude mcp get longbridge # config + auth status
claude mcp remove longbridge # unregister
claude mcp logout longbridge # re-trigger OAuth after revocation
首次使用時,用戶端會讀取 WWW-Authenticate 挑戰、取得 /.well-known/oauth-protected-resource(RFC 9728),並開啟瀏覽器以進行 Longbridge OAuth 流程。權杖會依工作階段快取,並自動更新。
164 個工具
涵蓋市場資料、交易、研究及帳戶管理的二十個類別。
| 類別 | 數量 | 涵蓋範圍 |
|---|---|---|
| Quote | 32 | 即時及歷史報價、K 線、深度、經紀商、選擇權、權證、自選清單、資金流向、市場溫度、淡倉、選擇權成交量 |
| Fundamental | 33 | 財務報表/報告、業務分部、機構觀點、同業/估值、股息、EPS 預測、估值與估值比較、公司資訊/高階主管、股東、公司行動、營運指標 |
| Trade | 15 | 提交/取消/替換訂單、多腿選擇權組合訂單、持倉、餘額、成交、現金流、保證金 |
| Market | 15 | 市場狀態、產業/漲跌幅排行、經紀商持倉、A/H 溢價、交易統計、異常、沽空交易/保證金、指數成分股 |
| DCA | 9 | 建立/更新/暫停/恢復/停止定期定額計畫、執行歷史、統計、支援檢查 |
| Grid | 11 | 提交/替換/取消/暫停/重新啟動網格交易訂單、清單/詳細資料/觸發歷史查詢、個別代號設定資訊、一次性策略同意 |
| Sharelist | 8 | 社群自選清單 CRUD、新增/移除/排序成員、熱門清單 |
| IPO | 7 | IPO 認購、日曆、已上市股票、訂單詳細資料、損益分析 |
| Content | 7 | 新聞清單/詳細資料、討論主題 CRUD 及回覆 |
| Alert | 5 | 價格提醒 CRUD(新增、刪除、啟用、停用、列出) |
| Screener | 5 | 股票篩選器搜尋、指標、策略建議/管理 |
| Portfolio | 4 | 匯率、損益分析(摘要、詳細資料、已實現) |
| ATM | 3 | 銀行卡、提款紀錄、存款紀錄 |
| Macrodata | 2 | 總體經濟指標清單及詳細資料 |
| Search | 2 | 新聞搜尋、社群主題搜尋 |
| Statement | 2 | 帳戶結單清單及匯出 |
| Calendar | 1 | 財經日曆(業績、股息、IPO、總體經濟資料、休市日) |
| Quant | 1 | 使用歷史 K 線資料執行量化指標指令碼 |
| Authenticate | 1 | 為無法完成瀏覽器重新導向的用戶端交換 OAuth 授權碼 |
| Utility | 1 | 目前 UTC 時間 |
自行託管
偏好使用自己的執行個體?執行已發布的映像檔:
docker run -p 8443:8443 \
-v /path/to/certs:/certs:ro \
ghcr.io/longbridge/longbridge-mcp \
--bind 0.0.0.0:8443 \
--base-url https://mcp.example.com \
--tls-cert /certs/cert.pem \
--tls-key /certs/key.pem
將
--base-url設為任何公開部署中外部可連線的 URL — 此 URL 會發布在 OAuth 中繼資料中,供用戶端探索授權伺服器。預設值為http://localhost:{port},遠端用戶端無法使用。
或從原始碼建置:cargo build --release && ./target/release/longbridge-mcp。
設定與環境變數
設定檔位於 ~/.longbridge/mcp/config.json(使用 LONGBRIDGE_MCP_CONFIG_DIR 覆寫目錄)。CLI 旗標優先。當 tls_cert 和 tls_key 同時設定時,伺服器會使用 HTTPS,否則使用 HTTP;base_url 在啟用 TLS 時預設為 https://localhost:{port},未啟用時則預設為 http://localhost:{port}。
| 選項 | 設定鍵 | CLI 旗標 | 預設值 | 說明 |
|---|---|---|---|---|
| 綁定位址 | bind | --bind | 127.0.0.1:8000 | HTTP 伺服器監聽位址 |
| 基底 URL | base_url | --base-url | 自動 | 資源中繼資料的公開基底 URL |
| 記錄目錄 | log_dir | --log-dir | (stderr) | 輪替記錄檔的目錄 |
| TLS 憑證 | tls_cert | --tls-cert | (無) | HTTPS 使用的 PEM 憑證檔 |
| TLS 私密金鑰 | tls_key | --tls-key | (無) | HTTPS 使用的 PEM 私密金鑰檔 |
| Canary 上游 | canary | --canary | false | 連線至 Longbridge Canary 環境(*.longbridge.xyz)。即使設定檔啟用 Canary,--canary=false 仍會強制使用正式環境 |
中國大陸環境(*.longbridge.cn)不是旗標:設定 LONGBRIDGE_REGION=cn 時會自動選取(SDK 使用的同一個變數),因此中國大陸叢集無需專用設定。
上游端點由所選環境決定:
| 正式環境(預設) | Canary(--canary) | 中國大陸(LONGBRIDGE_REGION=cn) | |
|---|---|---|---|
| OpenAPI | https://openapi.longbridge.com | https://openapi-global.longbridge.xyz | https://openapi.longbridge.cn |
| 報價 WebSocket | wss://openapi-quote.longbridge.com/v2 | wss://openapi-global-quote.longbridge.xyz/v2 | wss://openapi-quote.longbridge.cn/v2 |
| 交易 WebSocket | wss://openapi-trade.longbridge.com/v2 | wss://openapi-global-trade.longbridge.xyz/v2 | wss://openapi-trade.longbridge.cn/v2 |
| OAuth/連線頁面 | openapi.longbridge.com / open.longbridge.com | openapi-global.longbridge.xyz / open.longbridge.xyz | openapi.longbridge.cn / open.longbridge.cn |
Canary 使用 -global 閘道,而非 openapi.longbridge.xyz:只有前者由 CloudFront 提供服務,並執行 x-dc-region 資料中心路由;本伺服器依賴此功能,才能在單一程序中服務以 us_ 和 ap_ 為前綴的憑證。
Canary 和中國大陸環境會在啟動時固定上述所有 URL;正式環境則交由 SDK 自行解析,但若 us_ 憑證未設定上游覆寫,則會固定使用全球 .com 閘道。確切的選取規則請參閱 src/endpoints.rs。
進階環境變數 — 大多數部署都不需要調整;這些變數供 SDK 偵錯及邊緣/全球入口部署使用。
| 變數 | 預設值 | 說明 |
|---|---|---|
LONGBRIDGE_MCP_CONFIG_DIR | ~/.longbridge/mcp | 設定檔目錄 |
LONGBRIDGE_PUBLIC_HOSTS | (無) | 以逗號分隔、可接受由邊緣注入的 X-Host 標頭所帶主機名稱;符合的請求會在 401 挑戰/RFC 9728 中繼資料中回傳該主機名稱。未設定 = 忽略 X-Host |
LONGBRIDGE_GLOBAL_OAUTH_URL | (無) | 對透過允許清單中的 X-Host(全球單一網域入口)送達的請求所公告的授權伺服器 URL。未設定 = 使用該模式的 OpenAPI 基底 URL |
LONGBRIDGE_MCP_QUOTE_WS_IDLE_TTL_SECS | 600 | 快取的報價 WebSocket 內容閒置多久後逐出,單位為秒 |
LONGBRIDGE_MCP_QUOTE_WS_MAX_CONTEXTS | 1024 | 每個伺服器程序可快取的報價 WebSocket 內容數量上限 |
LONGBRIDGE_MCP_LOG_PAYLOADS | (未設定) | 1 會取消酬載記錄上限(見下文)。切勿在正式環境中設定 |
LONGBRIDGE_LOG_PATH | (無) | SDK 內部記錄路徑。正式環境請保持未設定 — SDK 會在此寫入未篩選的請求/回應本文 |
記錄與客戶資料
MCP 請求和回應包含客戶資料 — 現金餘額、持倉、訂單歷史 — 而上游 SDK 框架則包含存取權杖。這些內容都不應出現在日誌檔案中,因此伺服器會限制可能輸出這些內容的日誌目標,不受 `RUST_LOG` 影響:| 目標 | 上限 | 否則會輸出的內容 |
|---|---|---|
longbridge_httpcli | warn | OpenAPI 請求和完整回應本文 (INFO) |
longbridge_wscli | warn | 每個 WebSocket 框架,包括驗證權杖 (INFO) |
longbridge::trade | warn | 訂單推送事件 (INFO) |
rmcp | info | 解碼後的 MCP 請求和完整工具結果 (DEBUG)、原始 JSON-RPC 框架 (TRACE) |
因此,提高詳細程度是安全的:RUST_LOG=debug(或 trace)會顯示伺服器本身的日誌,而不會洩漏客戶資料。兩個開關會破壞這項保護,且預設都為關閉 — LONGBRIDGE_MCP_LOG_PAYLOADS=1(移除上限;僅可在本機對測試帳戶使用)和 LONGBRIDGE_LOG_PATH(讓 SDK 將未篩選的本文寫入該目錄;設定時伺服器會在啟動時發出警告)。
HTTP 端點、驗證與指標
伺服器預期在 Authorization: Bearer <token> 中提供 Longbridge OAuth 存取權杖。若缺少驗證資訊或驗證無效,伺服器會回傳 401,並在 WWW-Authenticate 標頭中提供受保護資源中繼資料的連結,該中繼資料會引導用戶端前往 Longbridge OAuth 授權伺服器。
在請求中傳送 x-papertrading: true(或 1),即可讓請求在模擬交易環境中執行。上游會拒絕使用真實資金權杖發出的模擬交易請求,因此此標頭是安全防護,而非路由開關:它只能限制權杖可執行的操作。LONGBRIDGE_PAPERTRADING=true 則會為整個部署啟用此功能。
| 方法 | 路徑 | 說明 |
|---|---|---|
| GET | /.well-known/oauth-protected-resource | 受保護資源中繼資料 (RFC 9728) |
| GET | /.well-known/oauth-authorization-server | 授權伺服器中繼資料 (RFC 8414);公布直接連至 Longbridge 的授權/註冊端點,以及代理的權杖/撤銷端點 |
| POST | /oauth2/token | OAuth 權杖代理;從授權碼/重新整理權杖推導 x-dc-region,預設為 AP |
| POST | /oauth2/revoke | OAuth 撤銷代理;從權杖推導 x-dc-region,預設為 AP |
| GET | /metrics | Prometheus 指標 |
| POST/GET/DELETE | /mcp | MCP Streamable HTTP 端點(需要 Bearer 權杖) |
Prometheus 指標:mcp_tool_calls_total(計數器)、mcp_tool_call_duration_seconds(直方圖)和 mcp_tool_call_errors_total(計數器)— 每個指標都以 tool_name 為標籤。
開發
cargo +nightly fmt # format
cargo clippy # lint
cargo test # test
授權條款
以 MIT 授權條款 發布。