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ı kotasyonlar — ABD ve Hong Kong piyasalarında canlı ve geçmiş kotasyonları, mum grafiklerini, derinlik verilerini ve opsiyon verilerini isteyin.
  • Portföy ve alım satım — Pozisyonları, bakiyeyi ve işlemleri inceleyin ya da çok ayaklı opsiyon kombinasyonları da dahil olmak üzere emir gönderin, iptal edin ve değiştirin.
  • Temel veriler ve araştırma — Bir hisse senedi için finansal tabloları, temettüleri, analist görüşlerini, değerlemeleri ve şirket yöneticilerini alın.
  • Tarama ve takvimler — Hisse senedi tarayıcısında arama yapın veya kazançlar, temettüler, halka arzlar ve makroekonomik veriler için finans takvimini kontrol edin.
  • Uyarılar ve yinelenen planlar — Fiyat uyarıları oluşturun, düzenli aralıklarla sabit tutarda yatırım planlarını yönetin ve grid alım satım stratejileri oluşturun.
  • Filtrelenmiş yanıtlar — Büyük yanıtları yalnızca ihtiyacınız olan alanlarla sınırlamak için herhangi bir araca bir _jq ifadesi iletin.

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 Server

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

Longbridge aracı kurumu için resmi MCP sunucusu. Gerçek zamanlı fiyat teklifleri, opsiyonlar, emir yönlendirme, temel veriler, analist derecelendirmeleri, takvimler, halka arzlar, fiyat uyarıları, DCA planları, grid işlemleri, portföy analizleri ve topluluk hisse listelerinde 164 araç — ABD ve Hong Kong piyasalarını kapsar. rmcp ve axum kullanılarak Rust ile oluşturulmuştur.


Artık ChatGPT ve Claude'da yayında

Longbridge, ChatGPT Apps dizininde ve Claude Connectors dizininde resmi olarak listelenmiştir.
Piyasalarla doğal dilde konuşun — fiyat teklifleri, opsiyonlar, temel veriler ve kendi portföyünüz —
düzenlemeniz gereken yapılandırma dosyaları veya yapıştırmanız gereken token'lar olmadan.

Tek bir yerden ekleyinSonra sorun
ChatGPTSettings → Apps & Connectors → Longbridge ekleyin"NVDA bugün nasıl işlem görüyor?" · "HK pozisyonlarımı göster"
ClaudeSettings → Connectors → 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 güvenli hale getirilmiş uç nokta üzerinden çalışır — salt okunur piyasa verilerinin yanı sıra tam hesap, portföy ve işlem araçları; tümü kendi kimlik bilgilerinizle korunur.


Öne çıkanlar

  • 164 araç, tek uç nokta — ABD ve Hong Kong piyasalarında fiyat teklifleri, opsiyonlar, emir yönlendirme, temel veriler, analist araştırmaları, tarayıcılar, halka arzlar, uyarılar, DCA, grid işlemleri ve portföy analizleri.
  • Tasarım gereği durumsuz — her istek, Bearer token'ınızı doğrudan Longbridge SDK'sına iletir. Oturum yok, veritabanı yok, sunucu tarafında saklanan hiçbir şey yok.
  • OAuth 2.1, otomatik keşif — RFC 9728 korumalı kaynak ve RFC 8414 yetkilendirme sunucusu meta verileri; istemciler token yapıştırmadan akışı tamamlar.
  • Temiz, türlendirilmiş yanıtlar — snake_case alanları, RFC 3339 zaman damgaları, insanlar tarafından okunabilir semboller ve MCP kaynakları olarak sunulan türlendirilmiş yanıt şemaları.

rmcp ve axum ile Rust'ta oluşturulmuştur.

jq ile araç yanıtlarını filtreleme

Her araç, bağımsız değişkenlerinde isteğe bağlı bir _jq dizesi kabul eder. İfade, normal yanıt serileştirmesinden sonra döndürülen JSON'un tamamı ü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], 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 yürütülebilir dosyası gerekmez.

  • Özgün yanıtı korumak için _jq öğesini atlayın (veya null iletin).
  • Tek bir çıktı değeri doğrudan, birden çok değer dizi olarak, hiç değer olmaması ise [] 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çeriği olmayan 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ıştırılmadan önce reddedilir. Filtreleme çalışma zamanında başarısız olursa yanıt, aracın zaten çalıştırıldığını açıkça belirtir. Emir verme gibi yazma işlemlerini otomatik olarak yeniden denemeyin.
  • Ortam erişimi, dosya sistemi içe aktarımları ve günlük kaydı filtreleri kullanılamaz. Çıktı 10.000 değer ve 8 MiB ile sınırlıdır; sınır aşılırsa kısmi sonuç yerine hata döndürülür.

Filtreler yanıt biçimini değiştirebildiğinden araçlar sabit bir outputSchema bildirmez. Özgün türlendirilmiş şemalar, şema destekli araçlar için lb://tools/{tool-name}/output-schema konumundaki resources/list ve resources/read aracılığıyla kullanılabilir.

Kendi istemcinizi bağlayın

Longbridge, barındırılan bir uç noktayı https://mcp.longbridge.com adresinde çalıştırır — herhangi bir MCP istemcisini bu adrese yönlendirin ve istendiğinde OAuth akışını tamamlayın. Yetkilendirme RFC 9728 aracılığıyla otomatik olarak keşfedilir; yapıştırmanız gereken bir token yoktur.

Claude Code

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

Claude Desktop — claude_desktop_config.json dosyasına ekleyin, ardından yeniden başlatın:

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

Codex — sunucuyu ekleyin, ardından tarayıcıda OAuth akışını tamamlayın:

codex mcp add longbridge --url https://mcp.longbridge.com
codex mcp login longbridge

Cursor · Cline · Windsurf · Zed · diğer istemciler — istemcileri https://mcp.longbridge.com adresine, streamable-http aktarımını kullanacak şekilde yönlendirin.

Claude Code için daha fazla komut
# 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 sorgulamasını okur, /.well-known/oauth-protected-resource (RFC 9728) bilgisini alır 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, alım satım, araştırma ve hesap yönetimini kapsayan yirmi kategori.

KategoriSayıKapsam
Quote32Gerçek zamanlı ve geçmiş fiyat teklifleri, mum grafikleri, derinlik, aracı kurumlar, opsiyonlar, varantlar, izleme listeleri, sermaye akışı, piyasa sıcaklığı, açığa satış pozisyonları, opsiyon hacmi
Fundamental33Finansal 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 bilgileri/yöneticiler, hissedarlar, kurumsal işlemler, faaliyet ölçütleri
Trade15Emir gönderme/iptal etme/değiştirme, çok ayaklı opsiyon kombinasyon emirleri, pozisyonlar, bakiye, işlemler, nakit akışı, teminat
Market15Piyasa durumu, sektör/en çok hareket edenler sıralaması, aracı kurum varlıkları, A/H primi, işlem istatistikleri, anormallikler, açığa satış işlemleri/teminatı, endeks bileşenleri
DCA9Dolar maliyet ortalaması planı oluşturma/güncelleme/duraklatma/sürdürme/durdurma, işlem geçmişi, istatistikler, destek kontrolü
Grid11Grid işlem emri gönderme/değiştirme/iptal etme/askıya alma/yeniden başlatma, liste/ayrıntı/tetikleme geçmişi okumaları, sembol başına kurulum bilgileri, tek seferlik strateji onayı
Sharelist8Topluluk hisse listesi CRUD işlemleri, üye ekleme/çıkarma/sıralama, popüler listeler
IPO7Halka arz başvuruları, takvim, borsaya kote hisseler, emir ayrıntısı, kâr/zarar analizi
Content7Haber listesi/ayrıntısı, tartışma konusu CRUD işlemleri ve yanıtlar
Alert5Fiyat uyarısı CRUD işlemleri (ekleme, silme, etkinleştirme, devre dışı bırakma, listeleme)
Screener5Hisse tarayıcısı araması, göstergeler, strateji önerisi/yönetimi
Portfolio4Döviz kurları, kâr/zarar analizi (özet, ayrıntı, gerçekleşen)
ATM3Banka kartları, para çekme kayıtları, para yatırma kayıtları
Macrodata2Makroekonomik gösterge listesi ve ayrıntısı
Search2Haber arama, topluluk konusu arama
Statement2Hesap ekstresi listeleme ve dışa aktarma
Calendar1Finans takvimi (kazançlar, temettüler, halka arzlar, makro veriler, kapanışlar)
Quant1Geçmiş K-line verileri üzerinde nicel gösterge betiği çalıştırma
Authenticate1Tarayıcı yönlendirmesini tamamlayamayan istemciler için OAuth kodu değişimi
Utility1Geçerli UTC saati

Kendi sunucunuzda barındırma

Kendi örneğinizi mi tercih ediyorsunuz? Yayımlanmış imajı ç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 ayarını yapın — herkese açık herhangi bir dağıtımda, dışarıdan erişilebilen URL'niz olarak ayarlayın. Bu URL, istemcilerin yetkilendirme sunucusunu keşfetmek için kullandığı OAuth meta verilerinde yayımlanır. Varsayılan değer http://localhost:{port} olup uzak istemciler bunu kullanamaz.

Ya da 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 birlikte ayarlandığında sunucu HTTPS kullanır; aksi durumda HTTP kullanır. base_url, TLS varsa varsayılan olarak https://localhost:{port}, yoksa http://localhost:{port} değerini alır.

SeçenekYapılandırma AnahtarıCLI BayrağıVarsayılanAçıklama
Bağlama adresibind--bind127.0.0.1:8000HTTP sunucusunun dinleme adresi
Temel URLbase_url--base-urlotomatikKaynak meta verileri için herkese açık temel URL
Günlük dizinilog_dir--log-dir(stderr)Dönen günlük dosyalarının dizini
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 üst akışıcanary--canaryfalseLongbridge canary ortamıyla (*.longbridge.xyz) iletişim kurar. Yapılandırma dosyasında etkin olsa bile --canary=false üretim ortamını zorunlu kılar

Çin ana karası 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 Çin ana karasındaki bir küme için özel bir ayar gerekmez.

Üst akış uç noktaları seçilen ortama göre sabitlenir:

Üretim (varsayılan)Canary (--canary)Çin ana karası (LONGBRIDGE_REGION=cn)
OpenAPIhttps://openapi.longbridge.comhttps://openapi-global.longbridge.xyzhttps://openapi.longbridge.cn
Quote WebSocketwss://openapi-quote.longbridge.com/v2wss://openapi-global-quote.longbridge.xyz/v2wss://openapi-quote.longbridge.cn/v2
Trade 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 yerine -global ağ geçidini kullanır: yalnızca ilki CloudFront üzerinden sunulur ve bu sunucunun tek bir süreçten us_ ve ap_ önekli kimlik bilgilerine hizmet vermek için ihtiyaç duyduğu x-dc-region veri merkezi yönlendirmesini gerçekleştirir.

Canary ve Çin ana karası, yukarıdaki tüm URL'leri başlangıçta sabitler; üretim ise SDK'nın kendi çözümlemesini kullanır. Bunun tek istisnası, üst akış geçersiz kılma ayarı olmayan bir us_ kimlik bilgisinin küresel .com ağ geçidine sabitlenmesidir. Kesin seçim kuralları için src/endpoints.rs bölümüne bakın.

Gelişmiş ortam değişkenleri — çoğu dağıtım bunlara hiç dokunmaz; SDK hata ayıklaması ve uç/küresel giriş dağıtımları için bulunurlar.

DeğişkenVarsayılanAçıklama
LONGBRIDGE_MCP_CONFIG_DIR~/.longbridge/mcpYapılandırma dosyası dizini
LONGBRIDGE_PUBLIC_HOSTS(yok)Uç katman tarafından eklenen X-Host başlığından kabul edilen, virgülle ayrılmış ana bilgisayar adları; eşleşen istekler bu ana bilgisayar adını 401 sorgulamasında / RFC 9728 meta verilerinde yansıtır. Ayarlanmamışsa = X-Host yok sayılır
LONGBRIDGE_GLOBAL_OAUTH_URL(yok)İzin verilenler listesinde bulunan bir X-Host üzerinden gelen isteklere duyurulan yetkilendirme sunucusu URL'si (küresel tek alan adı girişi). Ayarlanmamışsa = modun OpenAPI temel URL'sine geri dönülür
LONGBRIDGE_MCP_QUOTE_WS_IDLE_TTL_SECS600Önbelleğe alınmış bir quote WebSocket bağlamının kaldırılmasından önceki boşta kalma süresi (saniye)
LONGBRIDGE_MCP_QUOTE_WS_MAX_CONTEXTS1024Sunucu süreci başına önbelleğe alınabilecek en fazla quote WebSocket bağlamı
LONGBRIDGE_MCP_LOG_PAYLOADS(ayarlanmamış)1 yük günlük 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 ayarlamayın — SDK, filtrelenmemiş istek/yanıt gövdelerini buraya yazar
Günlük kaydı ve müşteri verileri MCP istekleri ve yanıtları müşteri verileri taşır — nakit bakiyeleri, pozisyonlar, emir geçmişi — ve üst akış SDK çerçeveleri erişim belirteçleri taşır. Bunların hiçbiri günlük dosyasına yazılmamalıdır; bu nedenle sunucu, `RUST_LOG` değerinden bağımsız olarak, bunları yazdırabilecek günlük hedeflerini sınırlar:
HedefSınırAksi hâlde yazdıracağı içerik
longbridge_httpcliwarnOpenAPI istekleri ve tam yanıt gövdeleri (INFO)
longbridge_wscliwarnKimlik doğrulama belirteci dâhil her WebSocket çerçevesi (INFO)
longbridge::tradewarnEmir iletme olayları (INFO)
rmcpinfoÇözümlenmiş MCP istekleri ve tam araç sonuçları (DEBUG), ham JSON-RPC çerçeveleri (TRACE)

Dolayısıyla ayrıntı düzeyini artırmak güvenlidir: RUST_LOG=debug (veya trace), müşteri verilerini sızdırmadan sunucunun kendi günlüklerini gösterir. Bunu devre dışı bırakan iki seçenek vardır ve ikisi de varsayılan olarak kapalıdır — LONGBRIDGE_MCP_LOG_PAYLOADS=1 (sınırları kaldırır; yalnızca yerel ortamda bir test hesabıyla kullanın) ve LONGBRIDGE_LOG_PATH (SDK'nin filtrelenmemiş gövdeleri bu dizine yazmasını sağlar; ayarlandığında sunucu başlangıçta uyarı verir).

HTTP uç noktaları, kimlik doğrulama ve metrikler

Sunucu, Authorization: Bearer <token> içinde bir Longbridge OAuth erişim belirteci bekler. Kimlik doğrulama eksik veya geçersiz olduğunda, korumalı kaynak meta verilerine işaret eden bir WWW-Authenticate başlığıyla birlikte 401 döndürür; bu meta veriler istemcileri Longbridge OAuth yetkilendirme sunucusuna yönlendirir.

İsteği kâğıt üzerinde işlem ortamında çalıştırmak için isteğe x-papertrading: true (veya 1) gönderin. Üst akış, gerçek para belirteciyle yapılan kâğıt üzerinde işlem isteğini reddeder; bu nedenle başlık bir yönlendirme anahtarı değil, güvenlik önlemidir: yalnızca bir belirtecin yapabileceklerini kısıtlayabilir. LONGBRIDGE_PAPERTRADING=true ise bunu tüm dağıtım için etkinleştirir.

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 yetkilendirme/kayıt uç noktalarını ve vekil token/iptal uç noktalarını duyurur
POST/oauth2/tokenOAuth token vekili; x-dc-region değerini kod/yenileme belirtecinden türetir, varsayılan olarak AP kullanır
POST/oauth2/revokeOAuth iptal vekili; x-dc-region değerini belirteçten türetir, varsayılan olarak AP kullanır
GET/metricsPrometheus metrikleri
POST/GET/DELETE/mcpMCP Streamable HTTP uç noktası (Bearer belirteci gerekir)

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 etiketlenir.

Geliştirme

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

Lisans

MIT Lisansı kapsamında yayımlanmıştır.