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ư

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

  • Báo giá theo thời gian thực — Yêu cầu báo giá trực tiếp và lịch sử, biểu đồ nến, độ sâu thị trường và dữ liệu quyền chọn trên các thị trường Mỹ và Hồng Kông.
  • Danh mục đầu tư và giao dịch — Xem lại các vị thế, số dư và giao dịch đã khớp, hoặc gửi, hủy và thay thế lệnh, bao gồm cả các tổ hợp quyền chọn nhiều chân.
  • Thông tin cơ bản và nghiên cứu — Lấy báo cáo tài chính, cổ tức, nhận định của chuyên gia phân tích, định giá và thông tin lãnh đạo công ty của một cổ phiếu.
  • Sàng lọc và lịch — Tìm kiếm bằng công cụ sàng lọc cổ phiếu hoặc xem lịch tài chính để theo dõi báo cáo thu nhập, cổ tức, IPO và dữ liệu kinh tế vĩ mô.
  • Cảnh báo và kế hoạch định kỳ — Tạo cảnh báo giá, quản lý kế hoạch bình quân giá theo thời gian và thiết lập chiến lược giao dịch lưới.
  • Phản hồi đã lọc — Truyền biểu thức _jq vào bất kỳ công cụ nào để rút gọn phản hồi lớn, chỉ giữ lại các trường bạn cần.

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

Máy chủ MCP Longbridge

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

Máy chủ MCP chính thức dành cho công ty môi giới Longbridge. 164 công cụ bao gồm báo giá theo thời gian thực, quyền chọn, định tuyến lệnh, thông tin cơ bản, xếp hạng của chuyên gia 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 — hỗ trợ 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ó mặt trong danh mục ứng dụng ChatGPT và danh mục trình kết nối Claude.
Trao đổi với thị trường bằng ngôn ngữ tự nhiên — báo giá, quyền chọn, thông tin cơ bản và danh mục đầu tư của riêng 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 tại một nơiSau đó chỉ cần hỏi
ChatGPTCài đặt → Ứng dụng & Trình kết nối → thêm Longbridge"Hôm nay NVDA giao dịch thế nào?" · "Hiển thị các vị thế HK của tôi"
ClaudeCài đặt → Trình kết nối → thêm Longbridge (web · máy tính · 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 được gửi qua cùng một điểm cuối được lưu trữ, bảo mật bằng OAuth 2.1 và được mô tả bên dưới — dữ liệu thị trường chỉ đọc cùng các công cụ tài khoản, danh mục đầu tư và giao dịch đầy đủ, 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, thông tin cơ bản, nghiên cứu của chuyên gia phân tích, công cụ sàng 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.
  • Thiết kế phi trạng thái — mọi yêu cầu đều chuyển tiếp Bearer token trực tiếp đến Longbridge SDK. Không có phiên, không có cơ sở dữ liệu, không lưu trữ gì ở phía máy chủ.
  • Tự động phát hiện OAuth 2.1 — siêu dữ liệu tài nguyên được bảo vệ theo RFC 9728 và máy chủ ủy quyền theo RFC 8414; ứng dụng khách hoàn tất quy trình mà không cần dán mã thông báo.
  • Phản hồi rõ ràng, có kiểu dữ liệu — trường snake_case, dấu thời gian RFC 3339, mã chứng khoán dễ đọc và lược đồ phản hồi có kiểu dữ liệu được cung cấp 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 một chuỗi _jq tùy chọn trong các đối số. Biểu thức được áp dụng cho toàn bộ JSON 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 cho việc lọc phản hồi để 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 trường instructions của phản hồi MCP initialize; lược đồ của mỗi công cụ chỉ khai báo tên và kiểu của tham số tùy chọn. Ví dụ:

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

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 các 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 với 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 ban đầu.
  • Một giá trị đầu ra được trả về trực tiếp, nhiều giá trị được trả về dưới dạng mảng và không có giá trị nào được trả về 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 sẽ có sẵn dưới dạng mảng.
  • Lỗi công cụ và giải thích về quyền/không có dữ liệu không bị lọc.
  • Biểu thức rỗng, không hợp lệ hoặc không phải chuỗi sẽ bị từ chối trước khi công cụ chạy. Nếu lọc thất bại khi chạy, phản hồi sẽ nêu rõ công cụ đã được thực thi. Không tự động thử lại các thao tác ghi như đặt lệnh.
  • Không hỗ trợ truy cập môi trường, nhập tệp hệ thống và bộ lọc ghi nhật ký. Đầu ra bị 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 công bố outputSchema cố định. Lược đồ có kiểu dữ liệu ban đầu vẫn có sẵn thông qua resources/list và resources/read tại lb://tools/{tool-name}/output-schema đối với các công cụ có lược đồ.

Kết nối ứng dụng khách của riêng bạn

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

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" } } }

Codex — thêm máy chủ, sau đó hoàn tất OAuth trong trình duyệt:

codex mcp add longbridge --url https://mcp.longbridge.com
codex mcp login longbridge

Cursor · Cline · Windsurf · Zed · các ứng dụng khách khác — trỏ đến https://mcp.longbridge.com bằng giao 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, ứng dụng 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 để thực hiện quy trình OAuth của Longbridge. Mã thông báo được lưu vào bộ nhớ đệm theo phiên và tự động làm mới.

164 công cụ

Hai mươi danh mục bao quát 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á theo thời gian thực và lịch sử, biểu đồ nến, độ sâu thị trường, công ty 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
Thông tin cơ bản33Báo cáo/báo cáo tài chính, phân khúc kinh doanh, quan điểm của tổ chức, công ty cùng ngành/định giá, cổ tức, dự báo EPS, định giá và so sánh định giá, thông tin công ty/lãnh đạo, cổ đông, sự kiện 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ặng, vị thế, số dư, giao dịch đã khớp, dòng tiền, ký quỹ
Thị trường15Trạng thái thị trường, xếp hạng ngành/cổ phiếu biến động mạnh nhất, lượng nắm giữ của công ty môi giới, mức chênh lệch A/H, thống kê giao dịch, biến động bất thường, giao dịch/ký quỹ bán khống, 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 bình quân giá, lịch sử thực hiện, thống kê, kiểm tra hỗ trợ
Giao dịch lưới11Gửi/thay thế/hủy/tạm ngưng/khởi động lại lệnh giao dịch lưới, xem danh sách/chi tiết/lịch sử kích hoạt, thông tin thiết lập theo mã chứng khoán, chấp thuận 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ý mua 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, liệt kê)
Công cụ sàng lọc5Tìm kiếm cổ phiếu, chỉ báo, đề xuất/quản lý chiến lược
Danh mục đầu tư4Tỷ giá, phân tích lãi/lỗ (tóm tắt, chi tiết, đã thực hiện)
ATM3Thẻ ngân hàng, lịch sử rút tiền, lịch 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
Sao kê2Liệt kê và xuất sao kê tài khoản
Lịch1Lịch tài chính (báo cáo thu nhập, cổ tức, IPO, dữ liệu vĩ mô, ngày nghỉ)
Đị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 các ứng dụng 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ữ

Bạn muốn dùng phiên bản của riêng mình? Chạy image đã phát hành:

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 từ bên ngoài trong mọi triển khai công khai — URL này được công bố trong siêu dữ liệu OAuth mà ứng dụng khách dùng để tìm máy chủ ủy quyền. Giá trị mặc định là http://localhost:{port}, ứng dụng 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 hơn. Khi tls_cert và tls_key đều được đặt, máy chủ chạy HTTPS; nếu không thì chạy HTTP; base_url mặc định là https://localhost:{port} khi có TLS hoặc http://localhost:{port} khi không có.

Tùy chọnKhóa cấu hìnhCờ CLIMặc địnhMô tả
Địa chỉ liên kếtbind--bind127.0.0.1:8000Địa chỉ lắng nghe của 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 chứa các tệp nhật ký luân phiên
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
Máy chủ thượng nguồn Canarycanary--canaryfalseKết nối với môi trường Canary của Longbridge (*.longbridge.xyz). --canary=false buộc dùng môi trường production ngay cả khi tệp cấu hình bật Canary

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

Các điểm cuối thượng nguồn được cố định theo môi trường đã chọn:

Production (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
OAuth / trang 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 đầu tiên được CloudFront đặt phía trước và thực hiện định tuyến trung tâm dữ liệu x-dc-region, điều mà máy chủ này cần để phục vụ thông tin xác thực có tiền tố us_ và ap_ từ một tiến trình.

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

Các biến môi trường nâng cao — hầu hết các triển khai không cần dùng đến; chúng dành cho việc 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ó)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 do biên chèn; các yêu cầu khớp sẽ phản hồi lại tên máy chủ đó trong thử thách 401 / siêu dữ liệu RFC 9728. Không đặt = bỏ qua X-Host
LONGBRIDGE_GLOBAL_OAUTH_URL(không có)URL máy chủ ủy quyền được công bố cho các yêu cầu đến qua X-Host nằm trong danh sách cho phép (cổng vào toàn cầu dùng một miền). Không đặt = dùng URL cơ sở OpenAPI của chế độ làm phương án dự phòng
LONGBRIDGE_MCP_QUOTE_WS_IDLE_TTL_SECS600Số giây nhàn rỗi trước khi loại bỏ ngữ cảnh WebSocket báo giá đã lưu trong bộ nhớ đệm
LONGBRIDGE_MCP_QUOTE_WS_MAX_CONTEXTS1024Số ngữ cảnh WebSocket báo giá tối đa được lưu trong bộ nhớ đệm cho mỗi tiến trình máy chủ
LONGBRIDGE_MCP_LOG_PAYLOADS(chưa đặt)1 bỏ giới hạn kích thước nhật ký tải trọng (xem bên dưới). Không bao giờ đặt biến này trong môi trường production
LONGBRIDGE_LOG_PATH(không có)Đường dẫn nhật ký nội bộ của SDK. Để trống trong môi trường production — SDK ghi nội dung yêu cầu/phản hồi chưa được lọc vào đó
Ghi nhật ký & dữ liệu khách hàng Các yêu cầu và phản hồi MCP mang theo dữ liệu khách hàng — số dư tiền mặt, vị thế, lịch sử lệnh — còn các khung SDK từ hệ thống thượng nguồn mang theo mã thông báo truy cập. Không nội dung nào trong số đó nên được ghi vào tệp nhật ký, vì vậy máy chủ giới hạn các đích ghi nhật ký có thể in ra những dữ liệu này, bất kể `RUST_LOG`:
ĐíchGiới hạnNội dung có thể được in ra nếu không giới hạn
longbridge_httpcliwarnNội dung yêu cầu OpenAPI và toàn bộ nội dung phản hồi (INFO)
longbridge_wscliwarnMọi khung WebSocket, bao gồm cả mã thông báo 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, tăng mức độ chi tiết là an toàn: RUST_LOG=debug (hoặc trace) sẽ cung cấp nhật ký riêng của máy chủ mà không làm lộ dữ liệu khách hàng. Có hai tùy chọn có thể vô hiệu hóa điều này, cả hai đều tắt theo mặc định — LONGBRIDGE_MCP_LOG_PAYLOADS=1 (gỡ bỏ các giới hạn; chỉ sử dụng cục bộ với tài khoản thử nghiệm) và LONGBRIDGE_LOG_PATH (khiến SDK ghi nội dung chưa lọc vào thư mục đó; máy chủ sẽ cảnh báo khi khởi động nếu tùy chọn này được đặt).

Các điểm cuối HTTP, xác thực & chỉ số

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

Gửi x-papertrading: true (hoặc 1) trong một yêu cầu để chạy yêu cầu đó trên môi trường giao dịch mô phỏng. Hệ thống thượng nguồn từ chối yêu cầu giao dịch mô phỏng nếu dùng mã thông báo tiền thật, vì vậy tiêu đề này là một biện pháp bảo vệ an toàn chứ không phải công tắc định tuyến: nó chỉ có thể giới hạn những gì mã thông báo được phép thực hiện. Thay vào đó, LONGBRIDGE_PAPERTRADING=true bật chế độ này cho toàn bộ môi trường triển khai.

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); cô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ã thông báo OAuth; suy ra x-dc-region từ mã hoặc mã thông báo làm mới, mặc định là AP
POST/oauth2/revokeProxy thu hồi OAuth; suy ra x-dc-region từ mã thông báo, mặc định là AP
GET/metricsChỉ số Prometheus
POST/GET/DELETE/mcpĐiểm cuối MCP Streamable HTTP (yêu cầu mã thông báo Bearer)

Chỉ số Prometheus: mcp_tool_calls_total (bộ đếm), mcp_tool_call_duration_seconds (biểu đồ phân phối) và mcp_tool_call_errors_total (bộ đếm) — mỗi chỉ số được gắn nhãn theo tool_name.

Phát triển

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

Giấy phép

Phát hành theo Giấy phép MIT.