Longbridge

resmi

Pasar AS/HK — 110 alat: kuotasi real-time, opsi, pesanan, fundamental, peringatan, DCA & portofolio

Apa yang bisa Anda lakukan dengan Longbridge MCP?

  • Kutipan real-time — Minta kutipan langsung atau historis, candlestick, kedalaman, dan data opsi untuk simbol AS dan HK melalui alat quote.
  • Operasi perdagangan — Tempatkan, batalkan, atau ganti pesanan, termasuk kombinasi opsi multi-kaki, dan periksa posisi, saldo, dan eksekusi.
  • Riset fundamental — Ambil laporan keuangan, dividen, perkiraan EPS, valuasi, dan peringkat analis untuk perusahaan.
  • Analitik portofolio — Dapatkan ringkasan laba/rugi, keuntungan terealisasi, dan nilai tukar untuk akun Longbridge Anda.
  • Peringatan harga — Buat, daftarkan, aktifkan, atau hapus peringatan harga untuk melacak pergerakan pasar.
  • DCA dan perdagangan grid — Siapkan, jeda, atau hentikan rencana rata-rata biaya dolar dan strategi perdagangan grid.

Server MCP Terhosting

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

Terpasang ke Claude Code, Codex, Cursor, dan lainnya

Dokumentasi

Longbridge

Longbridge MCP Server

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

Server MCP resmi untuk broker Longbridge. 164 alat mencakup kuotasi real-time, opsi, routing pesanan, fundamental, peringkat analis, kalender, IPO, peringatan harga, rencana DCA, trading grid, analitik portofolio, dan daftar berbagi komunitas — mencakup pasar AS dan HK. Dibangun dengan Rust menggunakan rmcp dan axum.


Sekarang tersedia di ChatGPT dan Claude

Longbridge secara resmi terdaftar di direktori ChatGPT Apps dan direktori Claude Connectors.
Bicaralah dengan pasar dalam bahasa sehari-hari — kuotasi, opsi, fundamental, dan portofolio Anda sendiri —
tanpa file konfigurasi yang perlu diedit dan tanpa token yang perlu ditempel.

Tambahkan di satu tempatLalu cukup tanyakan
ChatGPTSettings → Apps & Connectors → tambahkan Longbridge"Bagaimana perdagangan NVDA hari ini?" · "Tampilkan posisi HK saya"
ClaudeSettings → Connectors → tambahkan Longbridge (web · desktop · mobile)"Bandingkan valuasi AAPL dan MSFT" · "Ada IPO minggu ini?"

Masuk sekali dengan akun Longbridge Anda. Setiap permintaan berjalan melalui endpoint ter-hosting yang sama dan diamankan OAuth 2.1 yang didokumentasikan di bawah ini — data pasar hanya-baca plus akun penuh, portofolio, dan alat trading, semuanya dibatasi oleh kredensial Anda sendiri.


Sorotan

  • 164 alat, satu endpoint — kuotasi, opsi, routing pesanan, fundamental, riset analis, penyaring, IPO, peringatan, DCA, trading grid, dan analitik portofolio di pasar AS dan HK.
  • Stateless secara desain — setiap permintaan meneruskan token Bearer langsung ke Longbridge SDK. Tanpa sesi, tanpa database, tidak ada yang disimpan di sisi server.
  • OAuth 2.1, ditemukan otomatis — metadata sumber daya terlindungi RFC 9728 dan server otorisasi RFC 8414; klien menyelesaikan alur tanpa token yang perlu ditempel.
  • Respons bersih dan bertipe — bidang snake_case, stempel waktu RFC 3339, simbol yang dapat dibaca manusia, dan skema respons bertipe tersedia sebagai sumber daya MCP.

Dibangun dengan Rust menggunakan rmcp dan axum.

Filter respons alat dengan jq

Setiap alat menerima string _jq opsional dalam argumennya. Ekspresi berjalan pada JSON lengkap yang dikembalikan, setelah serialisasi respons normal. Nama _jq dicadangkan untuk pemfilteran respons guna menghindari konflik dengan parameter bisnis. Panduan penggunaan dikirim sekali dalam respons MCP initialize di instructions; setiap skema alat hanya mendeklarasikan nama dan tipe parameter opsional. Contohnya:

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

Gunakan .data[:5] untuk mengambil lima entri pertama dari array data, .data | map(select(.price > 10)) untuk memilih baris, atau {total: .total} untuk memproyeksikan bidang. Ekspresi menggunakan sintaks kompatibel jq dari mesin jaq yang tertanam; tidak perlu executable jq terpisah.

  • Hilangkan _jq (atau berikan null) untuk mempertahankan respons asli.
  • Satu nilai keluaran dikembalikan langsung, beberapa nilai sebagai array, dan tanpa nilai sebagai []. Skalar dan array adalah teks JSON; objek juga muncul di structuredContent, hanya berisi bidang yang difilter.
  • Respons teks biasa tersedia sebagai string JSON. Beberapa blok konten tanpa konten terstruktur tersedia sebagai array.
  • Kesalahan alat dan penjelasan izin/tanpa-data tetap tidak difilter.
  • Ekspresi kosong, tidak valid, atau non-string ditolak sebelum alat dijalankan. Jika pemfilteran gagal saat runtime, respons secara eksplisit menyatakan bahwa alat sudah dieksekusi. Jangan otomatis mencoba ulang operasi tulis seperti menempatkan pesanan.
  • Akses lingkungan, impor sistem file, dan filter logging tidak tersedia. Output dibatasi hingga 10.000 nilai dan 8 MiB; melebihi batas mengembalikan kesalahan daripada hasil parsial.

Karena filter dapat mengubah bentuk respons, alat tidak mengiklankan outputSchema tetap. Skema bertipe asli tetap tersedia melalui resources/list dan resources/read di lb://tools/{tool-name}/output-schema untuk alat berbasis skema.

Hubungkan klien Anda sendiri

Longbridge menjalankan endpoint ter-hosting di https://mcp.longbridge.com — arahkan klien MCP apa pun ke sana dan selesaikan OAuth saat diminta. Otorisasi ditemukan otomatis melalui RFC 9728; tidak ada token yang perlu ditempel.

Claude Code

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

Claude Desktop — tambahkan ke claude_desktop_config.json, lalu mulai ulang:

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

Cursor · Cline · Windsurf · Zed · klien lainnya — arahkan ke https://mcp.longbridge.com dengan transport streamable-http.

Perintah Claude Code lainnya
# 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

Pada penggunaan pertama, klien membaca tantangan WWW-Authenticate, mengambil /.well-known/oauth-protected-resource (RFC 9728), dan membuka browser Anda untuk alur OAuth Longbridge. Token di-cache per sesi dan disegarkan otomatis.

164 alat

Dua puluh kategori mencakup data pasar, trading, riset, dan manajemen akun.

KategoriJumlahCakupan
Kuotasi32Kuotasi real-time dan historis, candlestick, kedalaman, broker, opsi, waran, daftar pantau, aliran modal, suhu pasar, posisi pendek, volume opsi
Fundamental33Laporan keuangan, segmen bisnis, pandangan institusional, rekan industri/valuasi, dividen, perkiraan EPS, valuasi & perbandingan valuasi, info perusahaan/eksekutif, pemegang saham, aksi korporasi, metrik operasional
Trading15Pengiriman/pembatalan/penggantian pesanan, pesanan kombinasi opsi multi-kaki, posisi, saldo, eksekusi, arus kas, margin
Pasar15Status pasar, peringkat industri/penaik teratas, kepemilikan broker, premi A/H, statistik perdagangan, anomali, perdagangan pendek/margin, konstituen indeks
DCA9Buat/perbarui/jeda/lanjutkan/hentikan rencana rata-rata biaya dolar, riwayat eksekusi, statistik, pemeriksaan dukungan
Grid11Kirim/ganti/batalkan/tunda/mulai ulang pesanan trading grid, baca daftar/detail/riwayat pemicu, info pengaturan per simbol, persetujuan strategi satu kali
Daftar Berbagi8CRUD daftar berbagi komunitas, tambah/hapus/urutkan anggota, daftar populer
IPO7Langganan IPO, kalender, saham terdaftar, detail pesanan, analisis laba/rugi
Konten6Daftar/detail berita, CRUD topik diskusi dan balasan
Peringatan5CRUD peringatan harga (tambah, hapus, aktifkan, nonaktifkan, daftar)
Penyaring5Pencarian penyaring saham, indikator, rekomendasi/manajemen strategi
Portofolio4Nilai tukar, analisis laba/rugi (ringkasan, detail, terealisasi)
ATM3Kartu bank, catatan penarikan, catatan setoran
Makrodata2Daftar dan detail indikator ekonomi makro
Pencarian2Pencarian berita, pencarian topik komunitas
Pernyataan2Daftar dan ekspor pernyataan akun
Kalender1Kalender keuangan (pendapatan, dividen, IPO, data makro, penutupan)
Kuant1Jalankan skrip indikator kuantitatif terhadap data K-line historis
Autentikasi1Pertukaran kode OAuth untuk klien yang tidak dapat menyelesaikan pengalihan browser
Utilitas1Waktu UTC saat ini

Hosting mandiri

Lebih suka instance Anda sendiri? Jalankan image yang dipublikasikan:

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

Setel --base-url ke URL yang dapat dijangkau secara eksternal pada setiap deployment publik — ini dipublikasikan dalam metadata OAuth yang digunakan klien untuk menemukan server otorisasi. Defaultnya adalah http://localhost:{port}, yang tidak dapat digunakan oleh klien jarak jauh.

Atau bangun dari sumber: cargo build --release && ./target/release/longbridge-mcp.

Konfigurasi & variabel lingkungan

Konfigurasi berada di ~/.longbridge/mcp/config.json (timpa direktori dengan LONGBRIDGE_MCP_CONFIG_DIR). Bendera CLI lebih diutamakan. Saat tls_cert dan tls_key keduanya disetel, server menjalankan HTTPS, jika tidak HTTP; base_url default ke https://localhost:{port} dengan TLS atau http://localhost:{port} tanpa.

OpsiKunci KonfigurasiBendera CLIDefaultDeskripsi
Alamat bindbind--bind127.0.0.1:8000Alamat listen server HTTP
URL dasarbase_url--base-urlotomatisURL dasar publik untuk metadata sumber daya
Direktori loglog_dir--log-dir(stderr)Direktori untuk file log bergulir
Sertifikat TLStls_cert--tls-cert(tidak ada)File sertifikat PEM untuk HTTPS
Kunci privat TLStls_key--tls-key(tidak ada)File kunci privat PEM untuk HTTPS
Upstream canarycanary--canaryfalseBicaralah dengan lingkungan canary Longbridge (*.longbridge.xyz). --canary=false memaksa produksi bahkan saat file konfigurasi mengaktifkannya

Lingkungan Tiongkok daratan (*.longbridge.cn) bukan bendera: lingkungan ini dipilih otomatis saat LONGBRIDGE_REGION=cn disetel (variabel yang sama yang digunakan SDK), sehingga klaster daratan tidak memerlukan pengaturan khusus.

Endpoint upstream ditetapkan oleh lingkungan yang dipilih:

Produksi (default)Canary (--canary)Daratan (LONGBRIDGE_REGION=cn)
OpenAPIhttps://openapi.longbridge.comhttps://openapi-global.longbridge.xyzhttps://openapi.longbridge.cn
WebSocket Kuotasiwss://openapi-quote.longbridge.com/v2wss://openapi-global-quote.longbridge.xyz/v2wss://openapi-quote.longbridge.cn/v2
WebSocket Tradingwss://openapi-trade.longbridge.com/v2wss://openapi-global-trade.longbridge.xyz/v2wss://openapi-trade.longbridge.cn/v2
Halaman OAuth / koneksiopenapi.longbridge.com / open.longbridge.comopenapi-global.longbridge.xyz / open.longbridge.xyzopenapi.longbridge.cn / open.longbridge.cn

Canary menggunakan gateway -global, bukan openapi.longbridge.xyz: hanya yang pertama yang berhadapan dengan CloudFront dan melakukan routing pusat data x-dc-region, yang diandalkan server ini untuk melayani kredensial berawalan us_- dan ap_- dari satu proses.

Canary dan daratan memasang setiap URL di atas saat startup; produksi menunda ke resolusi SDK sendiri kecuali kredensial us_ tanpa override upstream dipasang ke gateway global .com. Lihat src/endpoints.rs untuk aturan pemilihan yang tepat.

Variabel lingkungan lanjutan — sebagian besar deployment tidak pernah menyentuhnya; variabel ini ada untuk debugging SDK dan deployment edge/entri global.

VariabelDefaultDeskripsi
LONGBRIDGE_MCP_CONFIG_DIR~/.longbridge/mcpDirektori file konfigurasi
LONGBRIDGE_PUBLIC_HOSTS(tidak ada)Nama host yang dipisahkan koma diterima dari header X-Host yang disuntikkan edge; permintaan yang cocok menggema host tersebut dalam tantangan 401 / metadata RFC 9728. Tidak disetel = X-Host diabaikan
LONGBRIDGE_GLOBAL_OAUTH_URL(tidak ada)URL server otorisasi yang diiklankan ke permintaan yang tiba melalui X-Host yang masuk daftar izin (entri domain tunggal global). Tidak disetel = kembali ke URL dasar OpenAPI mode
LONGBRIDGE_MCP_QUOTE_WS_IDLE_TTL_SECS600Detik idle sebelum konteks WebSocket kuotasi yang di-cache dikeluarkan
LONGBRIDGE_MCP_QUOTE_WS_MAX_CONTEXTS1024Maksimum konteks WebSocket kuotasi yang di-cache per proses server
LONGBRIDGE_MCP_LOG_PAYLOADS(tidak disetel)1 mengangkat batas log payload (lihat di bawah). Jangan pernah menyetel ini di produksi
LONGBRIDGE_LOG_PATH(tidak ada)Jalur log internal SDK. Biarkan tidak disetel di produksi — SDK menulis badan permintaan/respons yang tidak difilter di sana
Logging & data pelanggan Permintaan dan respons MCP membawa data pelanggan — saldo kas, posisi, riwayat pesanan — dan frame SDK upstream membawa token akses. Tidak ada satu pun yang seharusnya masuk ke file log, sehingga server membatasi target log yang akan mencetaknya, terlepas dari `RUST_LOG`:
TargetBatasYang seharusnya dicetak
longbridge_httpcliwarnPermintaan OpenAPI dan badan respons lengkap (INFO)
longbridge_wscliwarnSetiap frame WebSocket, termasuk token autentikasi (INFO)
longbridge::tradewarnPeristiwa push pesanan (INFO)
rmcpinfoPermintaan MCP yang didekode dan hasil alat lengkap (DEBUG), frame JSON-RPC mentah (TRACE)

Jadi meningkatkan verbositas aman: RUST_LOG=debug (atau trace) memberi Anda log server itu sendiri tanpa membocorkan data pelanggan. Dua sakelar menonaktifkan ini, keduanya nonaktif secara default — LONGBRIDGE_MCP_LOG_PAYLOADS=1 (menghapus batas; gunakan hanya terhadap akun uji secara lokal) dan LONGBRIDGE_LOG_PATH (membuat SDK menulis badan tanpa filter ke direktori tersebut; server memberi peringatan saat startup jika diatur).

Endpoint HTTP, autentikasi & metrik

Server mengharapkan token akses OAuth Longbridge di Authorization: Bearer <token>. Pada autentikasi yang hilang atau tidak valid, server mengembalikan 401 dengan header WWW-Authenticate yang menunjuk ke metadata sumber daya yang dilindungi, yang mengarahkan klien ke server otorisasi OAuth Longbridge.

Kirim x-papertrading: true (atau 1) pada permintaan untuk menjalankannya terhadap lingkungan perdagangan kertas. Upstream menolak permintaan perdagangan kertas yang dibuat dengan token uang sungguhan, sehingga header tersebut adalah pengaman daripada sakelar perutean: header hanya dapat mempersempit apa yang boleh dilakukan token. LONGBRIDGE_PAPERTRADING=true mengaktifkannya untuk seluruh deployment sebagai gantinya.

MetodeJalurDeskripsi
GET/.well-known/oauth-protected-resourceMetadata Sumber Daya yang Dilindungi (RFC 9728)
GET/.well-known/oauth-authorization-serverMetadata Server Otorisasi (RFC 8414); mengiklankan endpoint authorize/register Longbridge langsung dan endpoint token/revoke yang diproksi
POST/oauth2/tokenProksi token OAuth; menurunkan x-dc-region dari kode/token refresh, default ke AP
POST/oauth2/revokeProksi pencabutan OAuth; menurunkan x-dc-region dari token, default ke AP
GET/metricsMetrik Prometheus
POST/GET/DELETE/mcpEndpoint MCP Streamable HTTP (memerlukan token Bearer)

Metrik Prometheus: mcp_tool_calls_total (penghitung), mcp_tool_call_duration_seconds (histogram), dan mcp_tool_call_errors_total (penghitung) — masing-masing diberi label oleh tool_name.

Pengembangan

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

Lisensi

Dirilis di bawah Lisensi MIT.