Apache Doris için MCP Sunucusu, MPP tabanlı gerçek zamanlı bir veri ambarı. Claude, Cursor, VS Code ve diğer yapay zeka ajanları için Resmi Apache Doris…
Neler yapabilirsiniz?
- Doris sorgulama ve teşhis — doris_query alanı üzerinden sorgu yürütme, EXPLAIN planları, profil analizi veya yavaş sorgu teşhisi isteyin.
- Katalog ve şemayı keşfetme — doris_catalog alt araçlarıyla veritabanlarını, tabloları ve boyut ayrıntılarıyla tablo bağlamını keşfedin.
- Küme sağlığını izleme — doris_cluster alanını kullanarak düğümleri, görevleri, metrikleri, belleği, önbelleği ve sıkıştırma durumunu inceleyin.
- Veri hatlarını yönetme — doris_pipeline araçlarıyla alım durumunu, materyalize görünümleri, tazeliği ve bağımlılıkları kontrol edin.
- Veri arama ve analiz — doris_search alanı üzerinden metin, vektör veya hibrit aramalar çalıştırın ve dizinleri inceleyin.
- Yönetişim ve denetim — doris_governance yetenekleriyle veri kalitesini, depolamayı, veri soyunu, denetim günlüklerini ve UDF'leri gözden geçirin.
Apache Doris MCP Sunucusu
English |
Apache Doris MCP Sunucusu, MCP 2026-07-28 üzerinden MCP Ana Bilgisayarlarına ve yapay zeka aracılarına salt okunur Apache Doris yetenekleri sunar. Sürüm 1.0, geniş ve düz bir araç yüzeyini sekiz kararlı alan ve elli beş aşamalı olarak açılan alt yetenek ile değiştirir; çalışma zamanı kullanılabilirliğini, yetkilendirmeyi, girdi şemalarını, çıktı şemalarını ve hata davranışını açıkça korur.
Sürüm durumu
Paket sürümü 1.0.0'dir. master üzerindeki MCP 2026-07-28 protokol uyumluluğu, Streamable HTTP ve stdio üzerinde Genel Kullanıma Sunulmuştur (GA). Bu GA bildirimi protokol uyumluluğuyla sınırlıdır; Python paket sınıflandırıcısı Beta olarak kalır ve belgelenen dağıtım sınırlamaları hâlâ geçerlidir.
Yükseltmeden önce 1.0 sürüm notlarını, 1.0 geçiş kılavuzunu ve üretilen 8-alanlı/55-alt yetenek kaydını okuyun. Ayrıntılı sürüm kaydı Issue #189 içindedir.
Kısa mimari genel bakış
MCP Host -> stdio or Streamable HTTP -> transport security and authentication -> MCP protocol validation and authorization -> stable domain discovery -> route-aware Doris capability detection -> exact child dispatch and read-only runtime -> request-specific Doris route and RBAC -> bounded, schema-validated result
Varsayılan hierarchical modu şu alanları sunar:
| Alan | Alt yetenek | Sorumluluk |
|---|---|---|
doris_catalog |
5 | kataloglar, veritabanları, tablolar, tablo bağlamı, boyut |
doris_query |
7 | sorgu, explain, profil, tanılama, yavaş sorgular, açık ADBC |
doris_cluster |
11 | düğümler, görevler, metrikler, bellek, önbellek, sıkıştırma, iş yükleri |
doris_pipeline |
5 | veri alımı, materyalleştirilmiş görünümler, tazelik, bağımlılıklar |
doris_search |
4 | metin/vektör/hibrit arama, çözümleyiciler, dizinler, tanılama |
doris_governance |
8 | kalite, depolama, kanıt (lineage), denetim, UDF'ler, kimlik eşlemesi |
doris_lakehouse |
3 | harici kataloglar, lakehouse tabloları, Variant |
doris_semantic |
12 | isteğe bağlı Apache Ossie temellendirme ve MetricFlow tüketimi |
Bir alanı {} ile çağırın; yetkili alt yetenekleri ve tam şemaları keşfedin. Aynı alanı child_tool, arguments ve dönen manifest_version ile tekrar çağırın. Aşamalı açıklamayı kullanamayan ana bilgisayarlar, başlangıçtan önce MCP_TOOL_EXPOSURE_MODE=flat değerini ayarlayabilir; bu, aynı 55 alt yeteneği çakışmasız resmi adlar altında sunar ve 1.0 öncesi takma adları geri getirmez.
Bkz. Mimari, İstek yaşam döngüsü ve Araç alanları.
Hızlı başlangıç
Gereksinimler:
- Python 3.12 veya üzeri;
- Apache Doris 2.0.0 veya üzeri;
- Doris FE MySQL uç noktasına ağ erişimi, normalde
9030bağlantı noktası.
Sabitlenmiş sürümü yükleyin:
pip install doris-mcp-server==1.0.0
doris-mcp-server Sunucuyu başlatır. doris-mcp-client ayrı bir istemcidir; iki komut birbirinin yerine kullanılamaz.
Bir Doris rotası yapılandırın:
export DORIS_HOST=127.0.0.1
export DORIS_PORT=9030
export DORIS_USER=mcp_reader
export DORIS_PASSWORD='replace-me'
export DORIS_DATABASE=information_schema
Loopback üzerinde Streamable HTTP başlatın:
doris-mcp-server --transport http --host 127.0.0.1 --port 3000
Uç noktalar:
- MCP:
POST http://127.0.0.1:3000/mcp - eski MCP (isteğe bağlı):
POST http://127.0.0.1:3000/mcp/legacy - canlılık:
GET http://127.0.0.1:3000/live - Doris destekli hazır olma:
GET http://127.0.0.1:3000/ready
El sıkışma dönemi Streamable HTTP ile sınırlı ana bilgisayarlar (MCP 2025-06-18 ile Dify 1.16.1 dahil) ENABLE_LEGACY_HTTP_ADAPTER=true değerini ayarlamalı ve /mcp/legacy adresine bağlanmalıdır. Bağdaştırıcı yalnızca protokol sınırını değiştirir; aynı 1.0 araçlarını, yetkilendirmeyi, yetenek kapılarını ve salt okunur yürütmeyi korur.
Veya yerel bir Ana Bilgisayar için stdio çalıştırın:
doris-mcp-server --transport stdio
Tam Hızlı başlangıç ve Ana bilgisayar entegrasyon kılavuzuna bakın.
Güvenlik sınırı
- Yerleşik 1.0 kataloğu salt okunurdur;
doris_adminayrılmıştır ve kayıtlı değildir. - Statik belirteçler, JWT, harici OAuth/OIDC ve Doris destekli OAuth, karşılıklı doğrulanmış yapılandırma sınırları altında desteklenir.
- Alan keşfi ve alt yetenek yürütme, tam yetkilendirme tanımlayıcıları kullanır.
- Doris RBAC, görünür nesneler ve veriler için nihai otorite olmaya devam eder.
- SQL biçimi, tanımlayıcılar, parametreler, zaman aşımı, satırlar, baytlar ve sonuç şemaları, veriler Sunucudan çıkmadan önce sınırlandırılır.
- Sırlar ve arka uç hataları, genel sonuçlardan ve günlüklerden gizlenir.
- Açık bir tehlikeli geliştirme geçersiz kılması etkinleştirilmedikçe, loopback dışı HTTP kimlik doğrulaması gerektirir.
Güvenlik ve izin modelini ve Doris ayrıntılı erişim kılavuzunu okuyun.
Güvenilirlik sınırı
Sunucu; deterministik bildirimler ve hatalar, imzalı süresi dolan imleçler, rota farkında yetenek anlık görüntüleri, sınırlı eski geri dönüş, isteğe özel bağlantı yönlendirmesi, çoklu FE yük devretme, canlılık/hazır olma ayrımı, çıktı Şeması doğrulaması ve temizlenmiş iz yayılımı kullanır. Desteklenmeyen veya yanlış yapılandırılmış yetenekler callable=false ile keşfedilebilir durumda kalır ve çağrıldığında kapalı kalır (fail-closed).
Mevcut sınırlamalar şunları içerir: işlem yerel Doris destekli OAuth, varsayılan olarak devre dışı olan ve belirteç bağlı rotalarda kapalı kalır davranan yalnızca açık ADBC, isteğe bağlı salt okunur Ossie temellendirme, SQL'i sınırlı MCP sorgu çalışma zamanı aracılığıyla yürümesi gereken isteğe bağlı bir MetricFlow derleyici yardımcı işlemi ve en iyi çaba yerel kanıt (lineage) teslimi. Bkz. Güvenilirlik ve sınırlamalar.
Dokümantasyon
Kök README kasıtlı olarak bir giriş noktasıdır. İki dilli dokümantasyon sistemi şurada dizinlenmiştir:
Birincil kılavuzlar:
- Mimari
- İstek ve veri akışı
- Araç alanları
- Yetenek kullanılabilirliği
- Doris sürüm yetenek matrisi
- MetricFlow entegrasyonu
- MCP 2026-07-28 sözleşmesi
- Güvenlik modeli
- Dağıtım
- Güvenilirlik ve sınırlamalar
- Sorun giderme
- Yapılandırma başvurusu
- Ana bilgisayar entegrasyonları
- Özel araç sağlayıcıları
- Katkıda bulunma
Geliştirme
git clone https://github.com/apache/doris-mcp-server.git
cd doris-mcp-server
uv sync --group dev
uv run pytest
Üretilen yapıtlar senkronize kalmalıdır:
uv run python generate_tool_catalog.py --check
uv lock --check
Bkz. Katkıda bulunma ve doğrulama.
Lisans
Apache License 2.0. Bkz. LICENSE.txt ve NOTICE.
Kaynak: mcpservers.org