Longbridge
chính thứcThị 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?
- 实时行情 — 通过
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 MCP Server
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ơi | Sau đó chỉ cần hỏi | |
|---|---|---|
| ChatGPT | Cà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" |
| Claude | Cà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ềnnull) để 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 trongstructuredContent, 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ục | Số lượng | Phạm vi |
|---|---|---|
| Báo giá | 32 | Bá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ản | 33 | Bá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ịch | 15 | Gử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ường | 15 | Trạ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ố |
| DCA | 9 | Tạ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ưới | 11 | Gử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ẻ | 8 | CRUD 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 |
| IPO | 7 | Đă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 dung | 7 | Danh sách/chi tiết tin tức, CRUD chủ đề thảo luận và trả lời |
| Cảnh báo | 5 | CRUD cảnh báo giá (thêm, xóa, bật, tắt, danh sách) |
| Bộ lọc | 5 | Tì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ư | 4 | Tỷ giá hối đoái, phân tích lãi/lỗ (tóm tắt, chi tiết, đã thực hiện) |
| ATM | 3 | Thẻ ngân hàng, hồ sơ rút tiền, hồ sơ nạp tiền |
| Dữ liệu vĩ mô | 2 | Danh sách và chi tiết chỉ báo kinh tế vĩ mô |
| Tìm kiếm | 2 | Tìm kiếm tin tức, tìm kiếm chủ đề cộng đồng |
| Báo cáo | 2 | Liệt kê và xuất báo cáo tài khoản |
| Lịch | 1 | Lịch tài chính (thu nhập, cổ tức, IPO, dữ liệu vĩ mô, ngày đóng cửa) |
| Định lượng | 1 | Chạy tập lệnh chỉ báo định lượng trên dữ liệu K-line lịch sử |
| Xác thực | 1 | Trao đổ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 ích | 1 | Thờ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-urlthà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ọn | Khóa cấu hình | Cờ CLI | Mặc định | Mô tả |
|---|---|---|---|---|
| Địa chỉ ràng buộc | bind | --bind | 127.0.0.1:8000 | Địa chỉ lắng nghe máy chủ HTTP |
| URL cơ sở | base_url | --base-url | tự động | URL 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ỉ TLS | tls_cert | --tls-cert | (không có) | Tệp chứng chỉ PEM cho HTTPS |
| Khóa riêng TLS | tls_key | --tls-key | (không có) | Tệp khóa riêng PEM cho HTTPS |
| Upstream canary | canary | --canary | false | Kế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) | |
|---|---|---|---|
| OpenAPI | https://openapi.longbridge.com | https://openapi-global.longbridge.xyz | https://openapi.longbridge.cn |
| WebSocket báo giá | wss://openapi-quote.longbridge.com/v2 | wss://openapi-global-quote.longbridge.xyz/v2 | wss://openapi-quote.longbridge.cn/v2 |
| WebSocket giao dịch | wss://openapi-trade.longbridge.com/v2 | wss://openapi-global-trade.longbridge.xyz/v2 | wss://openapi-trade.longbridge.cn/v2 |
| Trang OAuth / kết nối | openapi.longbridge.com / open.longbridge.com | openapi-global.longbridge.xyz / open.longbridge.xyz | openapi.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ến | Mặc định | Mô tả |
|---|---|---|
LONGBRIDGE_MCP_CONFIG_DIR | ~/.longbridge/mcp | Thư 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_SECS | 600 | Giâ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_CONTEXTS | 1024 | Số 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:
| Đích | Giới hạn | Nội dung nếu không bị giới hạn |
|---|---|---|
longbridge_httpcli | warn | Yêu cầu OpenAPI và toàn bộ phần thân phản hồi (INFO) |
longbridge_wscli | warn | Mọi khung WebSocket, bao gồm mã xác thực (INFO) |
longbridge::trade | warn | Sự kiện đẩy lệnh (INFO) |
rmcp | info | Yê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ẫn | Mô tả |
|---|---|---|
| GET | /.well-known/oauth-protected-resource | Siêu dữ liệu tài nguyên được bảo vệ (RFC 9728) |
| GET | /.well-known/oauth-authorization-server | Siê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/token | Proxy mã OAuth; suy ra x-dc-region từ mã/refresh token, mặc định là AP |
| POST | /oauth2/revoke | Proxy thu hồi OAuth; suy ra x-dc-region từ mã, mặc định là AP |
| GET | /metrics | Số 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.