Longbridge

官方

美股/港股市場 — 110 項工具:即時報價、期權、訂單、基本面、提醒、DCA 及投資組合

你可以用 Longbridge MCP 做什麼?

  • 即時報價 — 查詢美國和香港市場的即時與歷史報價、K 線、深度資料和期權資料。
  • 投資組合與交易 — 檢視持倉、餘額和成交紀錄,或提交、取消及修改訂單,包括多腿期權組合。
  • 基本面與研究 — 查詢股票的財務報表、股息、分析師觀點、估值和公司高層資料。
  • 篩選與日曆 — 執行股票篩選搜尋,或查看財經日曆中的業績、股息、IPO 和宏觀經濟數據。
  • 提醒與定期計劃 — 建立價格提醒、管理定期定額計劃,並設定網格交易策略。
  • 篩選回應 — 將 _jq 表達式傳遞給任何工具,將大型回應精簡為所需欄位。

託管 MCP 伺服器

npx add-mcp 'https://mcp.longbridge.com'

可安裝到 Claude Code、Codex、Cursor 等客戶端

文件

Longbridge

Longbridge MCP Server

ChatGPT App Claude Connector Official MCP Registry LobeHub longbridge-mcp MCP server License Longbridge

適用於 Longbridge 券商的官方 MCP 伺服器。提供 164 個工具,涵蓋即時報價、選擇權、訂單路由、基本面、分析師評級、日曆、IPO、價格提醒、定期定額計畫、網格交易、投資組合分析及社群自選清單,支援美國及香港市場。使用 Rust 搭配 rmcp 和 axum 建置。


現已在 ChatGPT 和 Claude 上線

Longbridge 已正式列入 ChatGPT Apps 目錄和 Claude Connectors 目錄。
以日常語言與市場互動——查詢報價、選擇權、基本面及您自己的投資組合——
無需編輯設定檔,也不必貼上權杖。

在一處新增然後直接詢問
ChatGPTSettings → Apps & Connectors → 新增 Longbridge「NVDA 今天的交易情況如何?」 · 「顯示我的香港持倉」
ClaudeSettings → 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 資源提供具型別的回應結構描述。

使用 Rust 搭配 rmcp 和 axum 建置。

使用 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 個工具

涵蓋市場資料、交易、研究及帳戶管理的二十個類別。

類別數量涵蓋範圍
Quote32即時及歷史報價、K 線、深度、經紀商、選擇權、權證、自選清單、資金流向、市場溫度、淡倉、選擇權成交量
Fundamental33財務報表/報告、業務分部、機構觀點、同業/估值、股息、EPS 預測、估值與估值比較、公司資訊/高階主管、股東、公司行動、營運指標
Trade15提交/取消/替換訂單、多腿選擇權組合訂單、持倉、餘額、成交、現金流、保證金
Market15市場狀態、產業/漲跌幅排行、經紀商持倉、A/H 溢價、交易統計、異常、沽空交易/保證金、指數成分股
DCA9建立/更新/暫停/恢復/停止定期定額計畫、執行歷史、統計、支援檢查
Grid11提交/替換/取消/暫停/重新啟動網格交易訂單、清單/詳細資料/觸發歷史查詢、個別代號設定資訊、一次性策略同意
Sharelist8社群自選清單 CRUD、新增/移除/排序成員、熱門清單
IPO7IPO 認購、日曆、已上市股票、訂單詳細資料、損益分析
Content7新聞清單/詳細資料、討論主題 CRUD 及回覆
Alert5價格提醒 CRUD(新增、刪除、啟用、停用、列出)
Screener5股票篩選器搜尋、指標、策略建議/管理
Portfolio4匯率、損益分析(摘要、詳細資料、已實現)
ATM3銀行卡、提款紀錄、存款紀錄
Macrodata2總體經濟指標清單及詳細資料
Search2新聞搜尋、社群主題搜尋
Statement2帳戶結單清單及匯出
Calendar1財經日曆(業績、股息、IPO、總體經濟資料、休市日)
Quant1使用歷史 K 線資料執行量化指標指令碼
Authenticate1為無法完成瀏覽器重新導向的用戶端交換 OAuth 授權碼
Utility1目前 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--bind127.0.0.1:8000HTTP 伺服器監聽位址
基底 URLbase_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--canaryfalse連線至 Longbridge Canary 環境(*.longbridge.xyz)。即使設定檔啟用 Canary,--canary=false 仍會強制使用正式環境

中國大陸環境(*.longbridge.cn)不是旗標:設定 LONGBRIDGE_REGION=cn 時會自動選取(SDK 使用的同一個變數),因此中國大陸叢集無需專用設定。

上游端點由所選環境決定:

正式環境(預設)Canary(--canary)中國大陸(LONGBRIDGE_REGION=cn)
OpenAPIhttps://openapi.longbridge.comhttps://openapi-global.longbridge.xyzhttps://openapi.longbridge.cn
報價 WebSocketwss://openapi-quote.longbridge.com/v2wss://openapi-global-quote.longbridge.xyz/v2wss://openapi-quote.longbridge.cn/v2
交易 WebSocketwss://openapi-trade.longbridge.com/v2wss://openapi-global-trade.longbridge.xyz/v2wss://openapi-trade.longbridge.cn/v2
OAuth/連線頁面openapi.longbridge.com / open.longbridge.comopenapi-global.longbridge.xyz / open.longbridge.xyzopenapi.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_SECS600快取的報價 WebSocket 內容閒置多久後逐出,單位為秒
LONGBRIDGE_MCP_QUOTE_WS_MAX_CONTEXTS1024每個伺服器程序可快取的報價 WebSocket 內容數量上限
LONGBRIDGE_MCP_LOG_PAYLOADS(未設定)1 會取消酬載記錄上限(見下文)。切勿在正式環境中設定
LONGBRIDGE_LOG_PATH(無)SDK 內部記錄路徑。正式環境請保持未設定 — SDK 會在此寫入未篩選的請求/回應本文
記錄與客戶資料 MCP 請求和回應包含客戶資料 — 現金餘額、持倉、訂單歷史 — 而上游 SDK 框架則包含存取權杖。這些內容都不應出現在日誌檔案中,因此伺服器會限制可能輸出這些內容的日誌目標,不受 `RUST_LOG` 影響:
目標上限否則會輸出的內容
longbridge_httpcliwarnOpenAPI 請求和完整回應本文 (INFO)
longbridge_wscliwarn每個 WebSocket 框架,包括驗證權杖 (INFO)
longbridge::tradewarn訂單推送事件 (INFO)
rmcpinfo解碼後的 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/tokenOAuth 權杖代理;從授權碼/重新整理權杖推導 x-dc-region,預設為 AP
POST/oauth2/revokeOAuth 撤銷代理;從權杖推導 x-dc-region,預設為 AP
GET/metricsPrometheus 指標
POST/GET/DELETE/mcpMCP 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 授權條款 發布。