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ı 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
_jqifadesi 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 MCP Server
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 ekleyin | Sonra sorun | |
|---|---|---|
| ChatGPT | Settings → Apps & Connectors → Longbridge ekleyin | "NVDA bugün nasıl işlem görüyor?" · "HK pozisyonlarımı göster" |
| Claude | Settings → 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 (veyanulliletin). - 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çerenstructuredContentiç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.
| Kategori | Sayı | Kapsam |
|---|---|---|
| Quote | 32 | Gerç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 |
| Fundamental | 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 bilgileri/yöneticiler, hissedarlar, kurumsal işlemler, faaliyet ölçütleri |
| Trade | 15 | Emir gönderme/iptal etme/değiştirme, çok ayaklı opsiyon kombinasyon emirleri, pozisyonlar, bakiye, işlemler, nakit akışı, teminat |
| Market | 15 | Piyasa 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 |
| DCA | 9 | Dolar maliyet ortalaması planı oluşturma/güncelleme/duraklatma/sürdürme/durdurma, işlem geçmişi, istatistikler, destek kontrolü |
| Grid | 11 | Grid 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ı |
| Sharelist | 8 | Topluluk hisse listesi CRUD işlemleri, üye ekleme/çıkarma/sıralama, popüler listeler |
| IPO | 7 | Halka arz başvuruları, takvim, borsaya kote hisseler, emir ayrıntısı, kâr/zarar analizi |
| Content | 7 | Haber listesi/ayrıntısı, tartışma konusu CRUD işlemleri ve yanıtlar |
| Alert | 5 | Fiyat uyarısı CRUD işlemleri (ekleme, silme, etkinleştirme, devre dışı bırakma, listeleme) |
| Screener | 5 | Hisse tarayıcısı araması, göstergeler, strateji önerisi/yönetimi |
| Portfolio | 4 | Döviz kurları, kâr/zarar analizi (özet, ayrıntı, gerçekleşen) |
| ATM | 3 | Banka kartları, para çekme kayıtları, para yatırma kayıtları |
| Macrodata | 2 | Makroekonomik gösterge listesi ve ayrıntısı |
| Search | 2 | Haber arama, topluluk konusu arama |
| Statement | 2 | Hesap ekstresi listeleme ve dışa aktarma |
| Calendar | 1 | Finans takvimi (kazançlar, temettüler, halka arzlar, makro veriler, kapanışlar) |
| Quant | 1 | Geçmiş K-line verileri üzerinde nicel gösterge betiği çalıştırma |
| Authenticate | 1 | Tarayıcı yönlendirmesini tamamlayamayan istemciler için OAuth kodu değişimi |
| Utility | 1 | Geç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-urlayarı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ğerhttp://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çenek | Yapılandırma Anahtarı | CLI Bayrağı | Varsayılan | Açıklama |
|---|---|---|---|---|
| Bağlama adresi | bind | --bind | 127.0.0.1:8000 | HTTP sunucusunun dinleme adresi |
| Temel URL | base_url | --base-url | otomatik | Kaynak meta verileri için herkese açık temel URL |
| Günlük dizini | log_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 | --canary | false | Longbridge 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) | |
|---|---|---|---|
| OpenAPI | https://openapi.longbridge.com | https://openapi-global.longbridge.xyz | https://openapi.longbridge.cn |
| Quote WebSocket | wss://openapi-quote.longbridge.com/v2 | wss://openapi-global-quote.longbridge.xyz/v2 | wss://openapi-quote.longbridge.cn/v2 |
| Trade 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 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şken | Varsayılan | Açıklama |
|---|---|---|
LONGBRIDGE_MCP_CONFIG_DIR | ~/.longbridge/mcp | Yapı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_SECS | 600 | Ö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_CONTEXTS | 1024 | Sunucu 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:| Hedef | Sınır | Aksi hâlde yazdıracağı içerik |
|---|---|---|
longbridge_httpcli | warn | OpenAPI istekleri ve tam yanıt gövdeleri (INFO) |
longbridge_wscli | warn | Kimlik doğrulama belirteci dâhil her WebSocket çerçevesi (INFO) |
longbridge::trade | warn | Emir iletme olayları (INFO) |
rmcp | info | Çö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ö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 yetkilendirme/kayıt uç noktalarını ve vekil token/iptal uç noktalarını duyurur |
| POST | /oauth2/token | OAuth token vekili; x-dc-region değerini kod/yenileme belirtecinden türetir, varsayılan olarak AP kullanır |
| POST | /oauth2/revoke | OAuth iptal vekili; x-dc-region değerini belirteçten türetir, varsayılan olarak AP kullanır |
| GET | /metrics | Prometheus metrikleri |
| POST/GET/DELETE | /mcp | MCP 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.