Longbridge
resmiABD/HK piyasaları — 110 araç: gerçek zamanlı fiyatlar, opsiyonlar, emirler, temel veriler, uyarılar, DCA ve portföy
Longbridge MCP ile neler yapabilirsiniz?
- Gerçek zamanlı fiyatlar —
quotearacı üzerinden ABD ve HK sembolleri için canlı veya geçmiş fiyatlar, mum grafikleri, derinlik ve opsiyon verileri isteyin. - İşlem işlemleri — Çok ayaklı opsiyon kombinasyonları dahil emir gönderin, iptal edin veya değiştirin; pozisyonları, bakiyeleri ve işlemleri kontrol edin.
- Temel araştırma — Şirketler için finansal tabloları, temettüleri, hisse başına kâr tahminlerini, değerlemeleri ve analist derecelendirmelerini çekin.
- Portföy analitiği — Longbridge hesabınız için kâr/zarar özetleri, gerçekleşen kazançlar ve döviz kurları alın.
- Fiyat alarmları — Piyasa hareketlerini takip etmek için fiyat alarmları oluşturun, listeleyin, etkinleştirin veya silin.
- DCA ve grid trading — Dolar maliyeti ortalaması planları ve grid trading stratejileri kurun, duraklatın veya durdurun.
Barındırılan MCP Sunucusu
npx add-mcp 'https://mcp.longbridge.com'Claude Code, Codex, Cursor ve daha fazlasına kurulur
Dokümantasyon
Longbridge MCP Sunucusu
Longbridge aracılık kurumu için resmi MCP sunucusu. 164 araç; gerçek zamanlı fiyatlar, opsiyonlar, emir iletimi, temel analiz, analist derecelendirmeleri, takvimler, halka arz, fiyat uyarıları, DCA planları, grid trading, portföy analitiği ve topluluk paylaşım listeleri — ABD ve HK piyasalarını kapsar. rmcp ve axum kullanılarak Rust ile geliştirilmiştir.
Artık ChatGPT ve Claude'da canlı
Longbridge, ChatGPT Apps dizininde ve Claude Connectors dizininde resmi olarak listelenmiştir.
Piyasalarla sade dille konuşun — fiyatlar, opsiyonlar, temel analizler ve kendi portföyünüz —
düzenlenecek yapılandırma dosyası veya yapıştırılacak token olmadan.
| Tek yerden ekleyin | Sonra sadece sorun | |
|---|---|---|
| ChatGPT | Ayarlar → Uygulamalar ve Bağlantılar → Longbridge ekleyin | "NVDA bugün nasıl işlem görüyor?" · "HK pozisyonlarımı göster" |
| Claude | Ayarlar → Bağlantılar → Longbridge ekleyin (web · masaüstü · mobil) | "AAPL ve MSFT değerlemelerini karşılaştır" · "Bu hafta halka arz var mı?" |
Longbridge hesabınızla bir kez oturum açın. Her istek, aşağıda belgelenen aynı barındırılan, OAuth 2.1 ile korunan uç nokta üzerinden çalışır — salt okunur piyasa verileri ve tam hesap, portföy ve işlem araçları; tümü kendi kimlik bilgilerinizle korunur.
Öne Çıkanlar
- 164 araç, tek uç nokta — fiyatlar, opsiyonlar, emir iletimi, temel analiz, analist araştırmaları, tarayıcılar, halka arz, uyarılar, DCA, grid trading ve portföy analitiği; ABD ve HK piyasalarında.
- Tasarım gereği durumsuz — her istek, Bearer token'ını doğrudan Longbridge SDK'sına iletir. Oturum yok, veritabanı yok, sunucu tarafında hiçbir şey saklanmaz.
- OAuth 2.1, otomatik keşfedilir — RFC 9728 korumalı kaynak ve RFC 8414 yetkilendirme sunucusu meta verileri; istemciler akışı yapıştırılacak token olmadan tamamlar.
- Temiz, türlendirilmiş yanıtlar — snake_case alanlar, RFC 3339 zaman damgaları, insan tarafından okunabilir semboller ve MCP kaynakları olarak sunulan türlendirilmiş yanıt şemaları.
rmcp ve axum ile Rust'ta geliştirilmiştir.
Araç yanıtlarını jq ile filtreleyin
Her araç, argümanlarında isteğe bağlı bir _jq dizesi kabul eder. İfade, normal yanıt serileştirmesinden sonra döndürülen tam JSON üzerinde çalışır. _jq adı, iş parametreleriyle çakışmaları önlemek için yanıt filtrelemeye ayrılmıştır. Kullanım yönergeleri, MCP initialize yanıtının instructions alanında bir kez gönderilir; her araç şeması yalnızca isteğe bağlı parametre adını ve türünü bildirir. Örneğin:
{
"name": "quote",
"arguments": {
"symbols": ["AAPL.US", "MSFT.US"],
"_jq": "map({symbol, last_done})"
}
}
Bir data dizisinin ilk beş öğesini almak için .data[:5] kullanın, satırları seçmek için .data | map(select(.price > 10)) veya alanları yansıtmak için {total: .total} kullanın. İfadeler, gömülü jaq motorunun jq uyumlu sözdizimini kullanır; ayrı bir jq çalıştırılabilir dosyası gerekmez.
- Orijinal yanıtı korumak için
_jqöğesini atlayın (veyanulliletin). - Tek bir çıktı değeri doğrudan döndürülür, birden çok değer dizi olarak ve hiçbir değer
[]olarak döndürülür. Skalerler ve diziler JSON metnidir; nesneler ayrıca yalnızca filtrelenmiş alanları içerenstructuredContentiçinde görünür. - Düz metin yanıtları JSON dizeleri olarak sunulur. Yapılandırılmış içerik olmadan birden çok içerik bloğu dizi olarak sunulur.
- Araç hataları ve izin/veri yok açıklamaları filtrelenmeden kalır.
- Boş, geçersiz veya dize olmayan ifadeler, araç çalışmadan önce reddedilir. Filtreleme çalışma zamanında başarısız olursa, yanıt aracın zaten yürütüldüğünü açıkça belirtir. Emir verme gibi yazma işlemlerini otomatik olarak yeniden denemeyin.
- Ortam erişimi, dosya sistemi içe aktarmaları ve günlük filtreleri kullanılamaz. Çıktı 10.000 değer ve 8 MiB ile sınırlıdır; bir sınırın aşılması kısmi sonuç yerine hata döndürür.
Filtreler yanıt şeklini değiştirebildiğinden, araçlar sabit bir outputSchema reklamı yapmaz. Orijinal türlendirilmiş şemalar, şema destekli araçlar için lb://tools/{tool-name}/output-schema adresindeki resources/list ve resources/read aracılığıyla kullanılabilir durumda kalır.
Kendi istemcinizi bağlayın
Longbridge, https://mcp.longbridge.com adresinde barındırılan bir uç nokta çalıştırır — herhangi bir MCP istemcisini buna yönlendirin ve istendiğinde OAuth'u tamamlayın. Yetkilendirme, RFC 9728 aracılığıyla otomatik olarak keşfedilir; yapıştırılacak token yoktur.
Claude Code
claude mcp add --transport http longbridge https://mcp.longbridge.com
Claude Desktop — claude_desktop_config.json öğesine ekleyin, ardından yeniden başlatın:
{ "mcpServers": { "longbridge": { "url": "https://mcp.longbridge.com" } } }
Cursor · Cline · Windsurf · Zed · diğer istemciler — bunları https://mcp.longbridge.com adresine streamable-http taşımasıyla yönlendirin.
Daha fazla Claude Code komutu
# 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
İlk kullanımda, istemci WWW-Authenticate sorgusunu okur, /.well-known/oauth-protected-resource (RFC 9728) getirir ve Longbridge OAuth akışı için tarayıcınızı açar. Token'lar oturum başına önbelleğe alınır ve otomatik olarak yenilenir.
164 araç
Piyasa verileri, işlem, araştırma ve hesap yönetimini kapsayan yirmi kategori.
| Kategori | Sayı | Kapsam |
|---|---|---|
| Fiyat | 32 | Gerçek zamanlı ve geçmiş fiyatlar, mum grafikleri, derinlik, aracılar, opsiyonlar, varantlar, izleme listeleri, sermaye akışı, piyasa sıcaklığı, açığa satış pozisyonları, opsiyon hacmi |
| Temel Analiz | 33 | Finansal tablolar/raporlar, iş segmentleri, kurumsal görüşler, sektör emsalleri/değerleme, temettüler, EPS tahminleri, değerlemeler ve değerleme karşılaştırması, şirket bilgisi/yöneticiler, hissedarlar, kurumsal işlemler, operasyonel metrikler |
| İşlem | 15 | Emir gönderme/iptal/değiştirme, çok ayaklı opsiyon kombinasyon emirleri, pozisyonlar, bakiye, işlemler, nakit akışı, marj |
| Piyasa | 15 | Piyasa durumu, sektör/en çok hareket eden sıralaması, aracı holdingleri, A/H primi, işlem istatistikleri, anormallikler, açığa satış işlemleri/marj, endeks bileşenleri |
| DCA | 9 | Dolar maliyeti ortalaması planı oluşturma/güncelleme/duraklatma/devam ettirme/durdurma, işlem geçmişi, istatistikler, destek kontrolü |
| Grid | 11 | Grid trading emri gönderme/değiştirme/iptal/askıya alma/yeniden başlatma, liste/detay/tetikleme geçmişi okumaları, sembol başına kurulum bilgisi, tek seferlik strateji onayı |
| Paylaşım Listesi | 8 | Topluluk paylaşım listesi CRUD, üye ekleme/kaldırma/sıralama, popüler listeler |
| Halka Arz | 7 | Halka arz abonelikleri, takvim, listelenen hisseler, emir detayı, kar/zarar analizi |
| İçerik | 7 | Haber listesi/detay, tartışma konusu CRUD ve yanıtlar |
| Uyarı | 5 | Fiyat uyarısı CRUD (ekleme, silme, etkinleştirme, devre dışı bırakma, listeleme) |
| Tarayıcı | 5 | Hisse senedi tarayıcı araması, göstergeler, strateji önerisi/yönetimi |
| Portföy | 4 | Döviz kurları, kar/zarar analizi (özet, detay, gerçekleşen) |
| ATM | 3 | Banka kartları, para çekme kayıtları, para yatırma kayıtları |
| Makro Veri | 2 | Makroekonomik gösterge listesi ve detayı |
| Arama | 2 | Haber araması, topluluk konusu araması |
| Hesap Özeti | 2 | Hesap özeti listeleme ve dışa aktarma |
| Takvim | 1 | Finans takvimi (kazançlar, temettüler, halka arzlar, makro veriler, kapanışlar) |
| Quant | 1 | Geçmiş K-line verilerine karşı quant gösterge betiği çalıştırma |
| Kimlik Doğrulama | 1 | Tarayıcı yönlendirmesini tamamlayamayan istemciler için OAuth kod değişimi |
| Yardımcı | 1 | Geçerli UTC saati |
Kendi kendine barındırma
Kendi örneğinizi mi tercih edersiniz? Yayınlanan görüntüyü çalıştırı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
--base-urldeğerini herhangi bir genel dağıtımda harici olarak erişilebilir URL'nize ayarlayın — istemcilerin yetkilendirme sunucusunu keşfetmek için kullandığı OAuth meta verilerinde yayınlanır. Varsayılan olarakhttp://localhost:{port}değerini kullanır; uzak istemciler bunu kullanamaz.
Veya kaynaktan derleyin: cargo build --release && ./target/release/longbridge-mcp.
Yapılandırma ve ortam değişkenleri
Yapılandırma ~/.longbridge/mcp/config.json konumunda bulunur (dizini LONGBRIDGE_MCP_CONFIG_DIR ile geçersiz kılın). CLI bayrakları önceliklidir. tls_cert ve tls_key ikisi de ayarlandığında sunucu HTTPS çalıştırır, aksi takdirde HTTP; base_url varsayılan olarak TLS ile https://localhost:{port} veya TLS olmadan http://localhost:{port} değerini kullanır.
| Seçenek | Yapılandırma Anahtarı | CLI Bayrağı | Varsayılan | Açıklama |
|---|---|---|---|---|
| Bağlama adresi | bind | --bind | 127.0.0.1:8000 | HTTP sunucusu dinleme adresi |
| Temel URL | base_url | --base-url | otomatik | Kaynak meta verileri için genel temel URL |
| Günlük dizini | log_dir | --log-dir | (stderr) | Dönen günlük dosyaları için dizin |
| TLS sertifikası | tls_cert | --tls-cert | (yok) | HTTPS için PEM sertifika dosyası |
| TLS özel anahtarı | tls_key | --tls-key | (yok) | HTTPS için PEM özel anahtar dosyası |
| Canary yukarı akış | canary | --canary | false | Longbridge canary ortamıyla konuşun (*.longbridge.xyz). --canary=false, yapılandırma dosyası etkinleştirdiğinde bile üretimi zorlar |
Anakara-Çin ortamı (*.longbridge.cn) bir bayrak değildir: LONGBRIDGE_REGION=cn ayarlandığında otomatik olarak seçilir (SDK'nın kullandığı değişkenin aynısı), bu nedenle anakara kümesi için özel bir ayar gerekmez.
Yukarı akış uç noktaları, seçilen ortama göre sabitlenir:
| Üretim (varsayılan) | Canary (--canary) | Anakara (LONGBRIDGE_REGION=cn) | |
|---|---|---|---|
| OpenAPI | https://openapi.longbridge.com | https://openapi-global.longbridge.xyz | https://openapi.longbridge.cn |
| Fiyat WebSocket | wss://openapi-quote.longbridge.com/v2 | wss://openapi-global-quote.longbridge.xyz/v2 | wss://openapi-quote.longbridge.cn/v2 |
| İşlem WebSocket | wss://openapi-trade.longbridge.com/v2 | wss://openapi-global-trade.longbridge.xyz/v2 | wss://openapi-trade.longbridge.cn/v2 |
| OAuth / bağlantı sayfası | openapi.longbridge.com / open.longbridge.com | openapi-global.longbridge.xyz / open.longbridge.xyz | openapi.longbridge.cn / open.longbridge.cn |
Canary, openapi.longbridge.xyz değil -global ağ geçidini kullanır: yalnızca ilki CloudFront ön uçludur ve bu sunucunun us_- ve ap_- önekli kimlik bilgilerini tek bir işlemden sunmak için bağlı olduğu x-dc-region veri merkezi yönlendirmesini gerçekleştirir.
Canary ve anakara, başlangıçta yukarıdaki her URL'yi sabitler; üretim, yukarı akış geçersiz kılması olmayan bir us_ kimlik bilgisinin genel .com ağ geçidine sabitlenmesi dışında SDK'nın kendi çözümlemesine ertelenir. Kesin seçim kuralları için src/endpoints.rs adresine bakın.
Gelişmiş ortam değişkenleri — çoğu dağıtım bunlara asla dokunmaz; SDK hata ayıklama ve uç/global giriş dağıtımları için vardır.
| Değişken | Varsayılan | Açıklama |
|---|---|---|
LONGBRIDGE_MCP_CONFIG_DIR | ~/.longbridge/mcp | Yapılandırma dosyası dizini |
LONGBRIDGE_PUBLIC_HOSTS | (yok) | Uçtan enjekte edilen X-Host başlığından kabul edilen virgülle ayrılmış ana bilgisayar adları; eşleşen istekler 401 sorgulamasında / RFC 9728 meta verilerinde bu ana bilgisayarı yansıtır. Ayarlandıysa = X-Host yok sayılır |
LONGBRIDGE_GLOBAL_OAUTH_URL | (yok) | İzin listesindeki bir X-Host (global tek alan adı girişi) aracılığıyla gelen isteklere reklamı yapılan yetkilendirme sunucusu URL'si. Ayarlandıysa = modun OpenAPI temel URL'sine geri döner |
LONGBRIDGE_MCP_QUOTE_WS_IDLE_TTL_SECS | 600 | Önbelleğe alınmış bir fiyat WebSocket bağlamının atılmasından önceki boşta kalma saniyeleri |
LONGBRIDGE_MCP_QUOTE_WS_MAX_CONTEXTS | 1024 | Sunucu işlemi başına maksimum önbelleğe alınmış fiyat WebSocket bağlamı |
LONGBRIDGE_MCP_LOG_PAYLOADS | (ayarlanmamış) | 1, yük günlüğü sınırlarını kaldırır (aşağıya bakın). Bunu üretimde asla ayarlamayın |
LONGBRIDGE_LOG_PATH | (yok) | SDK dahili günlük yolu. Üretimde ayarlanmamış bırakın — SDK filtrelenmemiş istek/yanıt gövdelerini oraya yazar |
Günlükleme ve müşteri verileri
MCP istekleri ve yanıtları müşteri verilerini taşır — nakit bakiyeleri, pozisyonlar, sipariş geçmişi — ve üst katman SDK çerçeveleri erişim belirteçlerini taşır. Bunların hiçbiri bir günlük dosyasına ait değildir, bu nedenle sunucu, bunları yazdıracak günlük hedeflerini `RUST_LOG`'ten bağımsız olarak sınırlar:| Hedef | Sınır | Aksi halde yazdıracağı şey |
|---|---|---|
longbridge_httpcli | warn | OpenAPI isteği ve tam yanıt gövdeleri (INFO) |
longbridge_wscli | warn | Her WebSocket çerçevesi, kimlik doğrulama belirteci dahil (INFO) |
longbridge::trade | warn | Sipariş push olayları (INFO) |
rmcp | info | Kodlanmış MCP istekleri ve tam araç sonuçları (DEBUG), ham JSON-RPC çerçeveleri (TRACE) |
Bu nedenle ayrıntı düzeyini artırmak güvenlidir: RUST_LOG=debug (veya trace) size müşteri verilerini sızdırmadan sunucunun kendi günlüklerini verir. Bunu devre dışı bırakan iki anahtar vardır, ikisi de varsayılan olarak kapalıdır — LONGBRIDGE_MCP_LOG_PAYLOADS=1 (sınırları kaldırır; yalnızca yerel olarak bir test hesabına karşı kullanın) ve LONGBRIDGE_LOG_PATH (SDK'nın filtrelenmemiş gövdeleri o dizine yazmasını sağlar; sunucu ayarlandığında başlangıçta uyarır).
HTTP uç noktaları, kimlik doğrulama ve metrikler
Sunucu, Authorization: Bearer <token> içinde bir Longbridge OAuth erişim belirteci bekler. Eksik veya geçersiz kimlik doğrulamada, istemcileri Longbridge OAuth yetkilendirme sunucusuna yönlendiren korumalı kaynak meta verilerini gösteren bir WWW-Authenticate başlığıyla 401 döndürür.
Bir isteğe x-papertrading: true (veya 1) gönderin; bu isteği kağıt ticaret ortamına karşı çalıştırın. Üst katman, gerçek para belirteciyle yapılan bir kağıt ticaret isteğini reddeder, bu nedenle başlık bir yönlendirme anahtarından ziyade bir güvenlik korumasıdır: yalnızca bir belirtecin yapabileceklerini daraltabilir. LONGBRIDGE_PAPERTRADING=true bunu tüm dağıtım için açar.
| Yöntem | Yol | Açıklama |
|---|---|---|
| GET | /.well-known/oauth-protected-resource | Korumalı Kaynak Meta Verileri (RFC 9728) |
| GET | /.well-known/oauth-authorization-server | Yetkilendirme Sunucusu Meta Verileri (RFC 8414); doğrudan Longbridge authorize/register ve proxy token/revoke uç noktalarını tanıtır |
| POST | /oauth2/token | OAuth belirteç proxy'si; kod/yenileme belirtecinden x-dc-region türetir, varsayılan AP |
| POST | /oauth2/revoke | OAuth iptal proxy'si; belirteçten x-dc-region türetir, varsayılan AP |
| GET | /metrics | Prometheus metrikleri |
| POST/GET/DELETE | /mcp | MCP Streamable HTTP uç noktası (Bearer belirteci gerektirir) |
Prometheus metrikleri: mcp_tool_calls_total (sayaç), mcp_tool_call_duration_seconds (histogram) ve mcp_tool_call_errors_total (sayaç) — her biri tool_name ile etiketlenmiştir.
Geliştirme
cargo +nightly fmt # format
cargo clippy # lint
cargo test # test
Lisans
MIT Lisansı altında yayınlanmıştır.