Longbridge

chính thức

Thị trường Mỹ/HK — 110 công cụ: báo giá thời gian thực, quyền chọn, lệnh, thông tin cơ bản, cảnh báo, DCA & danh mục đầu tư

GitHub
14
Dùng thử MCP nàyĐược tài trợ

Bạn có thể làm gì với Longbridge MCP?

  • 实时行情 — 通过 quote 工具获取美股和港股代码的实时或历史行情、K线、深度及期权数据。
  • 交易操作 — 下达、撤销或替换订单,包括多腿期权组合,并查看持仓、余额和成交记录。
  • 基本面研究 — 获取公司的财务报表、股息、每股收益预测、估值及分析师评级。
  • 投资组合分析 — 查看您 Longbridge 账户的盈亏汇总、已实现收益及汇率信息。
  • 价格提醒 — 创建、查看、启用或删除价格提醒,以跟踪市场动态。
  • 定投与网格交易 — 设置、暂停或停止定投计划及网格交易策略。

Máy chủ MCP được lưu trữ

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

Cài vào Claude Code, Codex, Cursor và nhiều công cụ khác

Tài liệu

Longbridge

Longbridge MCP Server

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

Máy chủ MCP chính thức cho sàn môi giới Longbridge. 164 công cụ bao gồm báo giá thời gian thực, quyền chọn, định tuyến lệnh, dữ liệu cơ bản, xếp hạng nhà phân tích, lịch, IPO, cảnh báo giá, kế hoạch DCA, giao dịch lưới, phân tích danh mục đầu tư và danh sách chia sẻ cộng đồng — bao phủ thị trường Mỹ và Hồng Kông. Được xây dựng bằng Rust với rmcp và axum.


Hiện có trên ChatGPT và Claude

Longbridge chính thức được niêm yết trong thư mục Ứng dụng ChatGPT và thư mục Kết nối Claude.
Trò chuyện với thị trường bằng ngôn ngữ tự nhiên — báo giá, quyền chọn, dữ liệu cơ bản và danh mục đầu tư của bạn —
không cần chỉnh sửa tệp cấu hình hay dán mã thông báo.

Thêm ở một nơiSau đó chỉ cần hỏi
ChatGPTCài đặt → Ứng dụng & Kết nối → thêm Longbridge"NVDA hôm nay giao dịch thế nào?" · "Hiển thị vị thế Hồng Kông của tôi"
ClaudeCài đặt → Kết nối → thêm Longbridge (web · máy tính để bàn · di động)"So sánh định giá AAPL và MSFT" · "Tuần này có IPO nào không?"

Đăng nhập một lần bằng tài khoản Longbridge của bạn. Mọi yêu cầu đều chạy qua cùng một điểm cuối được lưu trữ, bảo mật OAuth 2.1 được mô tả bên dưới — dữ liệu thị trường chỉ đọc cùng với toàn bộ công cụ tài khoản, danh mục đầu tư và giao dịch, tất cả đều được kiểm soát bằng thông tin xác thực của riêng bạn.


Điểm nổi bật

  • 164 công cụ, một điểm cuối — báo giá, quyền chọn, định tuyến lệnh, dữ liệu cơ bản, nghiên cứu nhà phân tích, bộ lọc, IPO, cảnh báo, DCA, giao dịch lưới và phân tích danh mục đầu tư trên thị trường Mỹ và Hồng Kông.
  • Không trạng thái theo thiết kế — mọi yêu cầu chuyển tiếp mã thông báo Bearer của nó trực tiếp đến SDK Longbridge. Không có phiên, không có cơ sở dữ liệu, không lưu trữ gì ở phía máy chủ.
  • OAuth 2.1, tự động khám phá — siêu dữ liệu tài nguyên được bảo vệ RFC 9728 và máy chủ ủy quyền RFC 8414; máy khách hoàn tất luồng mà không cần dán mã thông báo.
  • Phản hồi sạch, có kiểu dữ liệu — trường snake_case, dấu thời gian RFC 3339, ký hiệu dễ đọc và lược đồ phản hồi có kiểu dữ liệu có sẵn dưới dạng tài nguyên MCP.

Được xây dựng bằng Rust với rmcp và axum.

Lọc phản hồi công cụ bằng jq

Mọi công cụ chấp nhận chuỗi _jq tùy chọn trong đối số của nó. Biểu thức chạy trên toàn bộ JSON được trả về, sau khi tuần tự hóa phản hồi thông thường. Tên _jq được dành riêng để lọc phản hồi nhằm tránh xung đột với các tham số nghiệp vụ. Hướng dẫn sử dụng được gửi một lần trong instructions của phản hồi MCP initialize; mỗi lược đồ công cụ chỉ khai báo tên và loại tham số tùy chọn. Ví dụ:

{
  "name": "quote",
  "arguments": {
    "symbols": ["AAPL.US", "MSFT.US"],
    "_jq": "map({symbol, last_done})"
  }
}

Sử dụng .data[:5] để lấy năm mục đầu tiên của mảng data, .data | map(select(.price > 10)) để chọn hàng hoặc {total: .total} để chiếu các trường. Biểu thức sử dụng cú pháp tương thích jq của công cụ jaq được nhúng; không cần tệp thực thi jq riêng.

  • Bỏ qua _jq (hoặc truyền null) để giữ nguyên phản hồi gốc.
  • Một giá trị đầu ra được trả về trực tiếp, nhiều giá trị dưới dạng mảng và không có giá trị nào dưới dạng []. Giá trị vô hướng và mảng là văn bản JSON; đối tượng cũng xuất hiện trong structuredContent, chỉ chứa các trường đã lọc.
  • Phản hồi văn bản thuần có sẵn dưới dạng chuỗi JSON. Nhiều khối nội dung không có nội dung có cấu trúc có sẵn dưới dạng mảng.
  • Lỗi công cụ và giải thích quyền/không có dữ liệu vẫn không bị lọc.
  • Biểu thức trống, không hợp lệ hoặc không phải chuỗi bị từ chối trước khi công cụ chạy. Nếu lọc thất bại trong thời gian chạy, phản hồi nêu rõ công cụ đã thực thi. Không tự động thử lại các thao tác ghi như đặt lệnh.
  • Truy cập môi trường, nhập tệp hệ thống và bộ lọc ghi nhật ký không khả dụng. Đầu ra được giới hạn ở 10.000 giá trị và 8 MiB; vượt quá giới hạn sẽ trả về lỗi thay vì kết quả một phần.

Vì bộ lọc có thể thay đổi hình dạng phản hồi, các công cụ không quảng cáo outputSchema cố định. Lược đồ có kiểu dữ liệu gốc vẫn có sẵn qua resources/list và resources/read tại lb://tools/{tool-name}/output-schema cho các công cụ hỗ trợ lược đồ.

Kết nối máy khách của riêng bạn

Longbridge chạy điểm cuối được lưu trữ tại https://mcp.longbridge.com — trỏ bất kỳ máy khách MCP nào vào đó và hoàn tất OAuth khi được nhắc. Ủy quyền được tự động khám phá qua RFC 9728; không có mã thông báo nào để dán.

Claude Code

claude mcp add --transport http longbridge https://mcp.longbridge.com

Claude Desktop — thêm vào claude_desktop_config.json, sau đó khởi động lại:

{ "mcpServers": { "longbridge": { "url": "https://mcp.longbridge.com" } } }

Cursor · Cline · Windsurf · Zed · các máy khách khác — trỏ chúng vào https://mcp.longbridge.com với phương thức truyền tải streamable-http.

Thêm lệnh 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

Khi sử dụng lần đầu, máy khách đọc thử thách WWW-Authenticate, tìm nạp /.well-known/oauth-protected-resource (RFC 9728) và mở trình duyệt của bạn cho luồng OAuth Longbridge. Mã thông báo được lưu trong bộ nhớ đệm theo phiên và tự động làm mới.

164 công cụ

Hai mươi danh mục bao phủ dữ liệu thị trường, giao dịch, nghiên cứu và quản lý tài khoản.

Danh mụcSố lượngPhạm vi
Báo giá32Báo giá thời gian thực và lịch sử, biểu đồ nến, độ sâu, nhà môi giới, quyền chọn, chứng quyền, danh sách theo dõi, dòng vốn, nhiệt độ thị trường, vị thế bán khống, khối lượng quyền chọn
Cơ bản33Báo cáo/báo cáo tài chính, phân khúc kinh doanh, quan điểm tổ chức, đối thủ cùng ngành/định giá, cổ tức, dự báo EPS, định giá & so sánh định giá, thông tin công ty/điều hành, cổ đông, hành động doanh nghiệp, chỉ số hoạt động
Giao dịch15Gửi/hủy/thay thế lệnh, lệnh kết hợp quyền chọn nhiều chân, vị thế, số dư, khớp lệnh, dòng tiền, ký quỹ
Thị trường15Trạng thái thị trường, xếp hạng ngành/cổ phiếu tăng mạnh, nắm giữ nhà môi giới, phí bảo hiểm A/H, thống kê giao dịch, bất thường, giao dịch bán khống/ký quỹ, thành phần chỉ số
DCA9Tạo/cập nhật/tạm dừng/tiếp tục/dừng kế hoạch trung bình chi phí đô la, lịch sử thực hiện, thống kê, kiểm tra hỗ trợ
Lưới11Gửi/thay thế/hủy/tạm dừng/khởi động lại lệnh giao dịch lưới, đọc danh sách/chi tiết/lịch sử kích hoạt, thông tin thiết lập theo ký hiệu, đồng ý chiến lược một lần
Danh sách chia sẻ8CRUD danh sách chia sẻ cộng đồng, thêm/xóa/sắp xếp thành viên, danh sách phổ biến
IPO7Đăng ký IPO, lịch, cổ phiếu niêm yết, chi tiết lệnh, phân tích lãi/lỗ
Nội dung7Danh sách/chi tiết tin tức, CRUD chủ đề thảo luận và trả lời
Cảnh báo5CRUD cảnh báo giá (thêm, xóa, bật, tắt, danh sách)
Bộ lọc5Tìm kiếm bộ lọc cổ phiếu, chỉ báo, đề xuất/quản lý chiến lược
Danh mục đầu tư4Tỷ giá hối đoái, phân tích lãi/lỗ (tóm tắt, chi tiết, đã thực hiện)
ATM3Thẻ ngân hàng, hồ sơ rút tiền, hồ sơ nạp tiền
Dữ liệu vĩ mô2Danh sách và chi tiết chỉ báo kinh tế vĩ mô
Tìm kiếm2Tìm kiếm tin tức, tìm kiếm chủ đề cộng đồng
Báo cáo2Liệt kê và xuất báo cáo tài khoản
Lịch1Lịch tài chính (thu nhập, cổ tức, IPO, dữ liệu vĩ mô, ngày đóng cửa)
Định lượng1Chạy tập lệnh chỉ báo định lượng trên dữ liệu K-line lịch sử
Xác thực1Trao đổi mã OAuth cho máy khách không thể hoàn tất chuyển hướng trình duyệt
Tiện ích1Thời gian UTC hiện tại

Tự lưu trữ

Thích phiên bản của riêng bạn? Chạy hình ảnh đã xuất bản:

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

Đặt --base-url thành URL có thể truy cập bên ngoài của bạn trên mọi triển khai công khai — nó được xuất bản trong siêu dữ liệu OAuth mà máy khách sử dụng để khám phá máy chủ ủy quyền. Mặc định là http://localhost:{port}, mà máy khách từ xa không thể sử dụng.

Hoặc xây dựng từ mã nguồn: cargo build --release && ./target/release/longbridge-mcp.

Cấu hình & biến môi trường

Cấu hình nằm tại ~/.longbridge/mcp/config.json (ghi đè thư mục bằng LONGBRIDGE_MCP_CONFIG_DIR). Cờ CLI được ưu tiên. Khi cả tls_cert và tls_key được đặt, máy chủ chạy HTTPS, nếu không thì HTTP; base_url mặc định là https://localhost:{port} với TLS hoặc http://localhost:{port} nếu không.

Tùy chọnKhóa cấu hìnhCờ CLIMặc địnhMô tả
Địa chỉ ràng buộcbind--bind127.0.0.1:8000Địa chỉ lắng nghe máy chủ HTTP
URL cơ sởbase_url--base-urltự độngURL cơ sở công khai cho siêu dữ liệu tài nguyên
Thư mục nhật kýlog_dir--log-dir(stderr)Thư mục cho tệp nhật ký xoay vòng
Chứng chỉ TLStls_cert--tls-cert(không có)Tệp chứng chỉ PEM cho HTTPS
Khóa riêng TLStls_key--tls-key(không có)Tệp khóa riêng PEM cho HTTPS
Upstream canarycanary--canaryfalseKết nối với môi trường canary Longbridge (*.longbridge.xyz). --canary=false buộc sản xuất ngay cả khi tệp cấu hình bật nó

Môi trường Trung Quốc đại lục (*.longbridge.cn) không phải là cờ: nó được tự động chọn khi LONGBRIDGE_REGION=cn được đặt (cùng biến mà SDK sử dụng), vì vậy cụm Trung Quốc đại lục không cần cài đặt riêng.

Điểm cuối upstream được cố định theo môi trường đã chọn:

Sản xuất (mặc định)Canary (--canary)Trung Quốc đại lục (LONGBRIDGE_REGION=cn)
OpenAPIhttps://openapi.longbridge.comhttps://openapi-global.longbridge.xyzhttps://openapi.longbridge.cn
WebSocket báo giáwss://openapi-quote.longbridge.com/v2wss://openapi-global-quote.longbridge.xyz/v2wss://openapi-quote.longbridge.cn/v2
WebSocket giao dịchwss://openapi-trade.longbridge.com/v2wss://openapi-global-trade.longbridge.xyz/v2wss://openapi-trade.longbridge.cn/v2
Trang OAuth / kết nốiopenapi.longbridge.com / open.longbridge.comopenapi-global.longbridge.xyz / open.longbridge.xyzopenapi.longbridge.cn / open.longbridge.cn

Canary sử dụng cổng -global, không phải openapi.longbridge.xyz: chỉ cổng trước được CloudFront phân phối và thực hiện định tuyến trung tâm dữ liệu x-dc-region, mà máy chủ này phụ thuộc vào để phục vụ thông tin xác thực có tiền tố us_- và ap_- từ một quy trình.

Canary và Trung Quốc đại lục ghim mọi URL ở trên khi khởi động; sản xuất hoãn việc phân giải của SDK ngoại trừ thông tin xác thực us_ không có ghi đè upstream được ghim vào cổng toàn cầu .com. Xem src/endpoints.rs để biết các quy tắc lựa chọn chính xác.

Biến môi trường nâng cao — hầu hết các triển khai không bao giờ chạm vào những biến này; chúng tồn tại để gỡ lỗi SDK và triển khai biên/cổng vào toàn cầu.

BiếnMặc địnhMô tả
LONGBRIDGE_MCP_CONFIG_DIR~/.longbridge/mcpThư mục tệp cấu hình
LONGBRIDGE_PUBLIC_HOSTS(không có)Danh sách tên máy chủ phân tách bằng dấu phẩy được chấp nhận từ tiêu đề X-Host được tiêm ở biên; các yêu cầu khớp lặp lại tên máy chủ đó trong thử thách 401 / siêu dữ liệu RFC 9728. Không đặt = X-Host bị bỏ qua
LONGBRIDGE_GLOBAL_OAUTH_URL(không có)URL máy chủ ủy quyền được quảng cáo cho các yêu cầu đến qua X-Host được đưa vào danh sách cho phép (mục nhập miền đơn toàn cầu). Không đặt = dự phòng vào URL cơ sở OpenAPI của chế độ
LONGBRIDGE_MCP_QUOTE_WS_IDLE_TTL_SECS600Giây nhàn rỗi trước khi ngữ cảnh WebSocket báo giá được lưu trong bộ nhớ đệm bị loại bỏ
LONGBRIDGE_MCP_QUOTE_WS_MAX_CONTEXTS1024Số ngữ cảnh WebSocket báo giá được lưu trong bộ nhớ đệm tối đa trên mỗi quy trình máy chủ
LONGBRIDGE_MCP_LOG_PAYLOADS(không đặt)1 nâng giới hạn nhật ký tải trọng (xem bên dưới). Không bao giờ đặt biến này trong sản xuất
LONGBRIDGE_LOG_PATH(không có)Đường dẫn nhật ký nội bộ SDK. Để trống trong sản xuất — SDK ghi nội dung yêu cầu/phản hồi không lọc ở đó
Ghi nhật ký & dữ liệu khách hàng

Các yêu cầu và phản hồi MCP mang dữ liệu khách hàng — số dư tiền mặt, vị thế, lịch sử lệnh — và các khung SDK phía trên mang mã truy cập. Không dữ liệu nào trong số đó thuộc về tệp nhật ký, vì vậy máy chủ giới hạn các đích nhật ký có thể in chúng, độc lập với RUST_LOG:

ĐíchGiới hạnNội dung nếu không bị giới hạn
longbridge_httpcliwarnYêu cầu OpenAPI và toàn bộ phần thân phản hồi (INFO)
longbridge_wscliwarnMọi khung WebSocket, bao gồm mã xác thực (INFO)
longbridge::tradewarnSự kiện đẩy lệnh (INFO)
rmcpinfoYêu cầu MCP đã giải mã và toàn bộ kết quả công cụ (DEBUG), khung JSON-RPC thô (TRACE)

Vì vậy, việc tăng mức chi tiết là an toàn: RUST_LOG=debug (hoặc trace) cung cấp cho bạn nhật ký của riêng máy chủ mà không làm lộ dữ liệu khách hàng. Hai công tắc vô hiệu hóa điều này, cả hai đều tắt theo mặc định — LONGBRIDGE_MCP_LOG_PAYLOADS=1 (xóa các giới hạn; chỉ sử dụng với tài khoản thử nghiệm cục bộ) và LONGBRIDGE_LOG_PATH (khiến SDK ghi các phần thân không lọc vào thư mục đó; máy chủ cảnh báo khi khởi động nếu được đặt).

Điểm cuối HTTP, xác thực & số liệu

Máy chủ mong đợi mã truy cập OAuth Longbridge trong Authorization: Bearer <token>. Khi thiếu hoặc xác thực không hợp lệ, máy chủ trả về 401 kèm tiêu đề WWW-Authenticate trỏ đến siêu dữ liệu tài nguyên được bảo vệ, hướng dẫn khách hàng đến máy chủ ủy quyền OAuth Longbridge.

Gửi x-papertrading: true (hoặc 1) trên một yêu cầu để chạy nó với môi trường giao dịch thử nghiệm. Phía trên từ chối yêu cầu giao dịch thử nghiệm được thực hiện bằng mã tiền thật, vì vậy tiêu đề là một biện pháp bảo vệ an toàn thay vì công tắc định tuyến: nó chỉ có thể thu hẹp những gì mã có thể làm. LONGBRIDGE_PAPERTRADING=true bật nó cho toàn bộ triển khai thay thế.

Phương thứcĐường dẫnMô tả
GET/.well-known/oauth-protected-resourceSiêu dữ liệu tài nguyên được bảo vệ (RFC 9728)
GET/.well-known/oauth-authorization-serverSiêu dữ liệu máy chủ ủy quyền (RFC 8414); quảng bá các điểm cuối authorize/register trực tiếp của Longbridge và các điểm cuối token/revoke qua proxy
POST/oauth2/tokenProxy mã OAuth; suy ra x-dc-region từ mã/refresh token, mặc định là AP
POST/oauth2/revokeProxy thu hồi OAuth; suy ra x-dc-region từ mã, mặc định là AP
GET/metricsSố liệu Prometheus
POST/GET/DELETE/mcpĐiểm cuối MCP Streamable HTTP (yêu cầu mã Bearer)

Số liệu Prometheus: mcp_tool_calls_total (bộ đếm), mcp_tool_call_duration_seconds (biểu đồ histogram), và mcp_tool_call_errors_total (bộ đếm) — mỗi cái được gắn nhãn bởi tool_name.

Phát triển

cargo +nightly fmt      # format
cargo clippy            # lint
cargo test              # test

Giấy phép

Được phát hành theo Giấy phép MIT.