Longbridge
resmiPasar 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 MCP Server
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 tempat | Lalu cukup tanyakan | |
|---|---|---|
| ChatGPT | Settings → Apps & Connectors → tambahkan Longbridge | "Bagaimana perdagangan NVDA hari ini?" · "Tampilkan posisi HK saya" |
| Claude | Settings → 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 berikannull) 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 distructuredContent, 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.
| Kategori | Jumlah | Cakupan |
|---|---|---|
| Kuotasi | 32 | Kuotasi real-time dan historis, candlestick, kedalaman, broker, opsi, waran, daftar pantau, aliran modal, suhu pasar, posisi pendek, volume opsi |
| Fundamental | 33 | Laporan keuangan, segmen bisnis, pandangan institusional, rekan industri/valuasi, dividen, perkiraan EPS, valuasi & perbandingan valuasi, info perusahaan/eksekutif, pemegang saham, aksi korporasi, metrik operasional |
| Trading | 15 | Pengiriman/pembatalan/penggantian pesanan, pesanan kombinasi opsi multi-kaki, posisi, saldo, eksekusi, arus kas, margin |
| Pasar | 15 | Status pasar, peringkat industri/penaik teratas, kepemilikan broker, premi A/H, statistik perdagangan, anomali, perdagangan pendek/margin, konstituen indeks |
| DCA | 9 | Buat/perbarui/jeda/lanjutkan/hentikan rencana rata-rata biaya dolar, riwayat eksekusi, statistik, pemeriksaan dukungan |
| Grid | 11 | Kirim/ganti/batalkan/tunda/mulai ulang pesanan trading grid, baca daftar/detail/riwayat pemicu, info pengaturan per simbol, persetujuan strategi satu kali |
| Daftar Berbagi | 8 | CRUD daftar berbagi komunitas, tambah/hapus/urutkan anggota, daftar populer |
| IPO | 7 | Langganan IPO, kalender, saham terdaftar, detail pesanan, analisis laba/rugi |
| Konten | 6 | Daftar/detail berita, CRUD topik diskusi dan balasan |
| Peringatan | 5 | CRUD peringatan harga (tambah, hapus, aktifkan, nonaktifkan, daftar) |
| Penyaring | 5 | Pencarian penyaring saham, indikator, rekomendasi/manajemen strategi |
| Portofolio | 4 | Nilai tukar, analisis laba/rugi (ringkasan, detail, terealisasi) |
| ATM | 3 | Kartu bank, catatan penarikan, catatan setoran |
| Makrodata | 2 | Daftar dan detail indikator ekonomi makro |
| Pencarian | 2 | Pencarian berita, pencarian topik komunitas |
| Pernyataan | 2 | Daftar dan ekspor pernyataan akun |
| Kalender | 1 | Kalender keuangan (pendapatan, dividen, IPO, data makro, penutupan) |
| Kuant | 1 | Jalankan skrip indikator kuantitatif terhadap data K-line historis |
| Autentikasi | 1 | Pertukaran kode OAuth untuk klien yang tidak dapat menyelesaikan pengalihan browser |
| Utilitas | 1 | Waktu 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-urlke URL yang dapat dijangkau secara eksternal pada setiap deployment publik — ini dipublikasikan dalam metadata OAuth yang digunakan klien untuk menemukan server otorisasi. Defaultnya adalahhttp://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.
| Opsi | Kunci Konfigurasi | Bendera CLI | Default | Deskripsi |
|---|---|---|---|---|
| Alamat bind | bind | --bind | 127.0.0.1:8000 | Alamat listen server HTTP |
| URL dasar | base_url | --base-url | otomatis | URL dasar publik untuk metadata sumber daya |
| Direktori log | log_dir | --log-dir | (stderr) | Direktori untuk file log bergulir |
| Sertifikat TLS | tls_cert | --tls-cert | (tidak ada) | File sertifikat PEM untuk HTTPS |
| Kunci privat TLS | tls_key | --tls-key | (tidak ada) | File kunci privat PEM untuk HTTPS |
| Upstream canary | canary | --canary | false | Bicaralah 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) | |
|---|---|---|---|
| OpenAPI | https://openapi.longbridge.com | https://openapi-global.longbridge.xyz | https://openapi.longbridge.cn |
| WebSocket Kuotasi | wss://openapi-quote.longbridge.com/v2 | wss://openapi-global-quote.longbridge.xyz/v2 | wss://openapi-quote.longbridge.cn/v2 |
| WebSocket Trading | wss://openapi-trade.longbridge.com/v2 | wss://openapi-global-trade.longbridge.xyz/v2 | wss://openapi-trade.longbridge.cn/v2 |
| Halaman OAuth / koneksi | openapi.longbridge.com / open.longbridge.com | openapi-global.longbridge.xyz / open.longbridge.xyz | openapi.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.
| Variabel | Default | Deskripsi |
|---|---|---|
LONGBRIDGE_MCP_CONFIG_DIR | ~/.longbridge/mcp | Direktori 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_SECS | 600 | Detik idle sebelum konteks WebSocket kuotasi yang di-cache dikeluarkan |
LONGBRIDGE_MCP_QUOTE_WS_MAX_CONTEXTS | 1024 | Maksimum 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`:| Target | Batas | Yang seharusnya dicetak |
|---|---|---|
longbridge_httpcli | warn | Permintaan OpenAPI dan badan respons lengkap (INFO) |
longbridge_wscli | warn | Setiap frame WebSocket, termasuk token autentikasi (INFO) |
longbridge::trade | warn | Peristiwa push pesanan (INFO) |
rmcp | info | Permintaan 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.
| Metode | Jalur | Deskripsi |
|---|---|---|
| GET | /.well-known/oauth-protected-resource | Metadata Sumber Daya yang Dilindungi (RFC 9728) |
| GET | /.well-known/oauth-authorization-server | Metadata Server Otorisasi (RFC 8414); mengiklankan endpoint authorize/register Longbridge langsung dan endpoint token/revoke yang diproksi |
| POST | /oauth2/token | Proksi token OAuth; menurunkan x-dc-region dari kode/token refresh, default ke AP |
| POST | /oauth2/revoke | Proksi pencabutan OAuth; menurunkan x-dc-region dari token, default ke AP |
| GET | /metrics | Metrik Prometheus |
| POST/GET/DELETE | /mcp | Endpoint 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.