Longbridge

resmi

ABD/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 — quote aracı ü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

Longbridge MCP Sunucusu

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

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 ekleyinSonra sadece sorun
ChatGPTAyarlar → Uygulamalar ve Bağlantılar → Longbridge ekleyin"NVDA bugün nasıl işlem görüyor?" · "HK pozisyonlarımı göster"
ClaudeAyarlar → 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 (veya null iletin).
  • 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çeren structuredContent iç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.

KategoriSayıKapsam
Fiyat32Gerç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 Analiz33Finansal 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
İşlem15Emir gönderme/iptal/değiştirme, çok ayaklı opsiyon kombinasyon emirleri, pozisyonlar, bakiye, işlemler, nakit akışı, marj
Piyasa15Piyasa 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
DCA9Dolar maliyeti ortalaması planı oluşturma/güncelleme/duraklatma/devam ettirme/durdurma, işlem geçmişi, istatistikler, destek kontrolü
Grid11Grid 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 Listesi8Topluluk paylaşım listesi CRUD, üye ekleme/kaldırma/sıralama, popüler listeler
Halka Arz7Halka arz abonelikleri, takvim, listelenen hisseler, emir detayı, kar/zarar analizi
İçerik7Haber listesi/detay, tartışma konusu CRUD ve yanıtlar
Uyarı5Fiyat uyarısı CRUD (ekleme, silme, etkinleştirme, devre dışı bırakma, listeleme)
Tarayıcı5Hisse senedi tarayıcı araması, göstergeler, strateji önerisi/yönetimi
Portföy4Döviz kurları, kar/zarar analizi (özet, detay, gerçekleşen)
ATM3Banka kartları, para çekme kayıtları, para yatırma kayıtları
Makro Veri2Makroekonomik gösterge listesi ve detayı
Arama2Haber araması, topluluk konusu araması
Hesap Özeti2Hesap özeti listeleme ve dışa aktarma
Takvim1Finans takvimi (kazançlar, temettüler, halka arzlar, makro veriler, kapanışlar)
Quant1Geçmiş K-line verilerine karşı quant gösterge betiği çalıştırma
Kimlik Doğrulama1Tarayıcı yönlendirmesini tamamlayamayan istemciler için OAuth kod değişimi
Yardımcı1Geç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-url değ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 olarak http://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çenekYapılandırma AnahtarıCLI BayrağıVarsayılanAçıklama
Bağlama adresibind--bind127.0.0.1:8000HTTP sunucusu dinleme adresi
Temel URLbase_url--base-urlotomatikKaynak meta verileri için genel temel URL
Günlük dizinilog_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--canaryfalseLongbridge 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)
OpenAPIhttps://openapi.longbridge.comhttps://openapi-global.longbridge.xyzhttps://openapi.longbridge.cn
Fiyat WebSocketwss://openapi-quote.longbridge.com/v2wss://openapi-global-quote.longbridge.xyz/v2wss://openapi-quote.longbridge.cn/v2
İşlem WebSocketwss://openapi-trade.longbridge.com/v2wss://openapi-global-trade.longbridge.xyz/v2wss://openapi-trade.longbridge.cn/v2
OAuth / bağlantı sayfasıopenapi.longbridge.com / open.longbridge.comopenapi-global.longbridge.xyz / open.longbridge.xyzopenapi.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şkenVarsayılanAçıklama
LONGBRIDGE_MCP_CONFIG_DIR~/.longbridge/mcpYapı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_SECS600Önbelleğe alınmış bir fiyat WebSocket bağlamının atılmasından önceki boşta kalma saniyeleri
LONGBRIDGE_MCP_QUOTE_WS_MAX_CONTEXTS1024Sunucu 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:
HedefSınırAksi halde yazdıracağı şey
longbridge_httpcliwarnOpenAPI isteği ve tam yanıt gövdeleri (INFO)
longbridge_wscliwarnHer WebSocket çerçevesi, kimlik doğrulama belirteci dahil (INFO)
longbridge::tradewarnSipariş push olayları (INFO)
rmcpinfoKodlanmış 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öntemYolAçıklama
GET/.well-known/oauth-protected-resourceKorumalı Kaynak Meta Verileri (RFC 9728)
GET/.well-known/oauth-authorization-serverYetkilendirme Sunucusu Meta Verileri (RFC 8414); doğrudan Longbridge authorize/register ve proxy token/revoke uç noktalarını tanıtır
POST/oauth2/tokenOAuth belirteç proxy'si; kod/yenileme belirtecinden x-dc-region türetir, varsayılan AP
POST/oauth2/revokeOAuth iptal proxy'si; belirteçten x-dc-region türetir, varsayılan AP
GET/metricsPrometheus metrikleri
POST/GET/DELETE/mcpMCP 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.