Aiven projelerinizde gezinin ve PostgreSQL®, Apache Kafka®, ClickHouse® ile OpenSearch® hizmetleriyle etkileşime geçin.
Neler yapabilirsiniz?
- Aiven projelerini listeleme ve inceleme — Projeleri taramak ve ayrıntılarını görüntülemek için aiven_project_list ve aiven_project_get kullanın.
- Aiven hizmetlerini yönetme — aiven_service_create, aiven_service_update ve aiven_service_get ile hizmetler oluşturun, güncelleyin veya alın.
- Kafka konuları ve bağlayıcılarıyla çalışma — Konuları listeleme, oluşturma, güncelleme, silme; mesaj üretme/tüketme ve Kafka Connect bağlayıcılarını yönetme.
- PostgreSQL hizmetlerinde SQL çalıştırma — aiven_pg_read ile salt okunur sorgular veya aiven_pg_write ile yazma ifadeleri yürütün.
- Uygulamaları dağıtma ve yeniden dağıtma — Aiven üzerinde Dockerize edilmiş uygulamaları yönetmek için aiven_application_deploy ve aiven_application_redeploy kullanın.
- Aiven belgelerini arama — aiven_docs_search aracılığıyla resmi belgeleri doğal dilde sorgulayın (yalnızca barındırılan sunucuda).
Aiven MCP Sunucusu
Aiven bulut veri platformu için bir Model Bağlam Protokolü (MCP) sunucusu.
PostgreSQL, Apache Kafka, uygulamalar ve diğer Aiven hizmetlerini doğrudan Claude, Cursor ve VS Code Copilot gibi yapay zeka asistanlarından yönetin.
[!WARNING]
Dikkatli kullanın. Bu MCP sunucusu, sizin adınıza Aiven hizmetleri ve verileri oluşturabilir, değiştirebilir ve silebilir. Yapay zeka aracıları, komut istemlerinizi yorumlamalarına dayanarak yıkıcı eylemler (veritabanlarını silme, hizmetleri kaldırma, mesaj üretme) gerçekleştirebilir. Bu araç aracılığıyla gerçekleştirilen eylemlerden tamamen siz sorumlusunuz.İzinler: Erişim, kimliği doğrulanmış hesapla ilişkili Aiven kullanıcı izinleri tarafından yönetilir. MCP sunucusu yalnızca Aiven kullanıcınızın yapmasına izin verilen eylemleri gerçekleştirebilir.
Yapay Zeka Aracı Güvenliği: Yapay zeka aracıları, sizin adınıza hareket etmek için erişim kimlik bilgilerine (veritabanı bağlantı dizeleri, akış belirteçleri) ihtiyaç duyabilir. Özellikle üretim ortamlarında aracınızın ne yaptığını inceleyin. Yapay zeka aracılarına hassas kaynaklara erişim vermeden önce kuruluşunuzun güvenlik politikalarına uyun ve bir risk değerlendirmesi yapın.
Hızlı Başlangıç
Seçenek 1: Uzak (Aiven tarafından barındırılır)
MCP sunucusu https://mcp.aiven.live/mcp adresinde barındırılmaktadır. MCP istemciniz sizi Aiven'de yetkilendirmeye yönlendirecektir.
Claude Code
claude mcp add --scope user --transport http aiven-mcp "https://mcp.aiven.live/mcp"
Cursor
Veya Cursor MCP ayarlarına manuel olarak ekleyin:
{ "mcpServers": { "aiven-mcp": { "url": "https://mcp.aiven.live/mcp" } }
}
VS Code / Copilot
Çalışma alanınızdaki .vscode/mcp.json dosyasına ekleyin:
{ "servers": { "aiven-mcp": { "type": "http", "url": "https://mcp.aiven.live/mcp" } }
}
Salt Okunur Mod (Uzak)
URL'ye ?read_only=true ekleyerek salt okunur modu etkinleştirin. Tüm yazma işlemleri MCP'den hariç tutulacaktır:
{ "mcpServers": { "aiven-mcp": { "url": "https://mcp.aiven.live/mcp?read_only=true" } }
}
Kapsamlı Araçlar (Uzak)
URL'ye ?services_scope= ekleyerek yapay zeka aracınıza sunulan araç yüzeyini azaltın. Yalnızca Aiven hizmetlerinin bir alt kümesiyle çalıştığınızda ve aracının bağlamını odaklı tutmak istediğinizde kullanışlıdır. Değerleri virgülle birleştirin. core (proje/hizmet keşfi) her zaman örtük olarak dahil edilir.
Geçerli kapsamlar: all, core, pg, kafka, application, integrations. Her aracı açıkça yüklemek için all kullanın (parametreyi atlamakla aynı). all diğer kapsamlarla birleştirilemez.
{ "mcpServers": { "aiven-mcp": { "url": "https://mcp.aiven.live/mcp?services_scope=kafka" } }
}
Ayrıca read_only ile birleştirebilirsiniz:
https://mcp.aiven.live/mcp?services_scope=pg&read_only=true
Salt Okunur Modda Yazma İstisnaları (Uzak)
read_only=true olduğunda, diğer her şeyi salt okunur tutarken belirli yazma araçlarını yeniden etkinleştirmek için ?write_allowlist= ekleyin. Çoğunlukla okuma erişimi istediğinizde ancak yine de bir yazma eylemine izin vermeniz gerektiğinde, örneğin Kafka konuları oluşturmak için kullanışlıdır. Birden çok araç adını virgülle birleştirin. read_only etkin değilken yok sayılır.
https://mcp.aiven.live/mcp?read_only=true&write_allowlist=aiven_kafka_topic_create
Pazar Yeri Müşterileri (Uzak)
Aiven'e bir bulut pazar yeri aracılığıyla abone olduysanız, oturum açmanın doğru konsolu kullanması için pazar yerinizi bir yol segmenti olarak ekleyin:
| Pazar Yeri | Yol segmenti |
|---|---|
| AWS Pazar Yeri | https://mcp.aiven.live/mcp/aws |
| Azure Pazar Yeri | https://mcp.aiven.live/mcp/azure |
| Google Cloud Pazar Yeri | https://mcp.aiven.live/mcp/gcp |
{ "mcpServers": { "aiven-mcp": { "url": "https://mcp.aiven.live/mcp/<marketplace>" } }
}
Yol segmenti yukarıdaki sorgu parametreleriyle birleşir, örneğin https://mcp.aiven.live/mcp/gcp?services_scope=pg&read_only=true.
Seçenek 2: stdio (yerel)
Sunucuyu MCP istemcinizin bir alt süreci olarak yerel olarak çalıştırın. Node.js 18+ gerektirir.
Aiven API belirtecinizi AIVEN_TOKEN ortam değişkeni aracılığıyla sağlamalısınız. Buradan bir belirteç oluşturun.
Claude Code
claude mcp add --scope user aiven-mcp -e AIVEN_TOKEN=your-token-here -- npx -y mcp-aiven
Cursor, VS Code — MCP istemci yapılandırmanıza ekleyin:
{ "mcpServers": { "aiven-mcp": { "command": "npx", "args": ["-y", "mcp-aiven"], "env": { "AIVEN_TOKEN": "your-token-here" } } }
}
Yapılandırma dosyası konumları:
- Cursor: Cursor Ayarları > MCP Sunucuları
- VS Code: Çalışma alanınızdaki
.vscode/mcp.json
Seçenek 3: Yerel geliştirme
Sunucunun yerel bir derlemesini çalıştırın (geliştirme ve test için kullanışlıdır):
pnpm install && pnpm generate:api-types && pnpm generate && pnpm build && AIVEN_TOKEN="<YOUR_TOKEN>" MCP_TRANSPORT="http" PORT=3000 node dist/index.js
Sunucu varsayılan olarak 3000 numaralı bağlantı noktasını dinler. MCP istemcinizi http://localhost:3000/mcp adresine bağlayın.
Uzak bir dağıtımı özel bir ana bilgisayara (ör. yerel derlemeniz) yönlendirmek için MCP_HOST ayarlayın:
MCP_HOST=http://localhost:3000 node dist/index.js
Ortam Değişkenleri
| Değişken | Gerekli | Varsayılan | Açıklama |
|---|---|---|---|
AIVEN_TOKEN |
yalnızca stdio | — | Aiven API belirteci (buradan bir tane oluşturun) |
AIVEN_READ_ONLY |
Hayır | false |
Yalnızca salt okunur araçları göstermek için true olarak ayarlayın |
AIVEN_SERVICES_SCOPE |
Hayır | — | Gösterilecek virgülle ayrılmış kapsamlar (ör. kafka, pg,kafka veya all). Geçerli: all, core, pg, kafka, application, integrations. core her zaman dahildir. Değişkeni atlamak veya all ayarlamak her aracı yükler. |
AIVEN_ALLOW_SECRETS |
Hayır | false |
Konuşmaya canlı kimlik bilgilerini (parolalar, bağlantı URI'leri, sertifikalar) döndüren aiven_service_connection_info aracını göstermek için true olarak ayarlayın. AIVEN_READ_ONLY=true iken devre dışıdır. |
AIVEN_WRITE_ALLOWLIST |
Hayır | — | AIVEN_READ_ONLY=true iken yeniden etkinleştirilecek virgülle ayrılmış araç adları (ör. aiven_kafka_topic_create). Salt okunur mod etkin değilken yok sayılır. |
MCP_HOST |
Hayır | https://mcp.aiven.live |
OAuth korumalı kaynak ana bilgisayarını geçersiz kıl |
MCP_TRANSPORT |
Hayır | stdio |
stdio yerine bir HTTP sunucusu başlatmak için http olarak ayarlayın |
MCP_HTTP_RATE_LIMIT_MAX |
Hayır | 1000 |
POST /mcp (HTTP aktarımı) üzerinde taşıyıcı belirteç başına pencere başına maksimum istek. İstemci IP hız sınırlaması Cloudflare'de beklenir. |
MCP_HTTP_RATE_LIMIT_WINDOW_MS |
Hayır | 60000 |
MCP_HTTP_RATE_LIMIT_MAX için milisaniye cinsinden pencere uzunluğu. |
EXTRA_PROTECTION |
Hayır | false |
GET /health dışındaki her istekte geçerli bir X-Edge-Auth başlığı gerektirmek için HTTP dağıtımlarında true olarak ayarlayın. Aşağıdaki Uç koruma kullanıma sunumu bölümüne bakın. |
MCP_EDGE_AUTH_SECRET |
EXTRA_PROTECTION=true olduğunda |
— | Paylaşılan gizli anahtar; Cloudflare'ın Dönüştürme Kuralları aracılığıyla X-Edge-Auth olarak enjekte ettiği değerle eşleşmelidir. |
Uzak (HTTP) modunda, AIVEN_TOKEN gerekli değildir. MCP istemciniz her istekle birlikte belirtecinizi bir Taşıyıcı belirteç olarak gönderir.
Üretim HTTP trafiği iki katmanda hız sınırlıdır: Cloudflare istemci IP'si başına bir sınır uygular (Cloudflare panosunda yapılandırılır) ve bu sunucu POST /mcp üzerinde taşıyıcı belirteç başına MCP_HTTP_RATE_LIMIT_* uygular.
Uç koruma kullanıma sunumu
EXTRA_PROTECTION=true olduğunda, MCP_EDGE_AUTH_SECRET ile Cloudflare'ın X-Edge-Auth olarak enjekte ettiği değer arasındaki herhangi bir uyumsuzluk, her isteğin 403 döndürmesine neden olur (GET /health hariç). Her iki değer de hattın karşıt taraflarında ortam/yapılandırmadır, bu nedenle tek kurtarma yolu gizli anahtarı düzeltip yeniden dağıtmak veya Cloudflare'ı güncellemektir.
Bu sırayla etkinleştirin:
- Cloudflare Dönüştürme Kuralı — MCP kaynağına giden trafikte
X-Edge-Auth(ve PG araçları için kullanılıyorsaX-Client-IP) ayarlayan bir kural ekleyin. Yapılandırdığınız gizli değeri not edin. MCP_EDGE_AUTH_SECRET— Sunucuyu, bu ortam değişkeni Dönüştürme Kuralı ile aynı gizli değere ayarlanmış olarak dağıtın.EXTRA_PROTECTIONöğesini şimdilik ayarsız veyafalseolarak bırakın; kaynağın hala trafiği kabul ettiğini doğrulayın.EXTRA_PROTECTION=true— Yalnızca 1–2. adımlar canlı ve eşleştikten sonra etkinleştirin. Normal bir MCP isteğinin başarılı olduğunu veX-Edge-Autholmadan doğrudan kaynak erişiminin reddedildiğini onaylayın.- Gizli anahtar döndürme — Cloudflare ve
MCP_EDGE_AUTH_SECRETöğesini birlikte güncelleyin (veya kısa süreliğineEXTRA_PROTECTION=falseayarlayın), yeniden dağıtın, ardından yeniden etkinleştirin. Bayrak açıkken asla tek bir tarafı tek başına döndürmeyin.
Başlangıçta EXTRA_PROTECTION=true ise ve MCP_EDGE_AUTH_SECRET eksikse, süreç hemen bir hatayla sonlanır.
Reddetmeler devam ederken, sunucu en fazla 15 dakikada bir yanlış yapılandırma uyarısı günlüğe kaydeder (geçerli X-Edge-Auth içeren bir istekten sonra sıfırlanır), böylece reddedilen istek başına bir satır olmadan günlüklerde bir gizli anahtar uyumsuzluğu görünür.
Araçlar
Çekirdek
| Araç | Açıklama |
|---|---|
aiven_project_list |
Projeleri listele |
aiven_project_get |
Proje ayrıntılarını al |
aiven_list_project_clouds |
Bir proje için bulut platformlarını listele |
aiven_project_vpc_list |
Bir proje için VPC'leri listele |
aiven_service_list |
Hizmetleri listele |
aiven_service_type_plans |
Bulut kullanılabilirliği olan planları listele |
aiven_service_plan_pricing |
Belirli bir buluttaki bir plan için fiyatlandırmayı al |
aiven_service_create |
Bir hizmet oluştur |
aiven_service_get |
Hizmet bilgilerini al |
aiven_service_update |
Bir hizmeti güncelle (plan, yapılandırma, güç durumu) |
aiven_service_metrics_fetch |
Yönetilen veri hizmetleri için metrikleri getir |
aiven_service_application_metrics_get |
Uygulama hizmetleri için metrikleri getir |
aiven_project_get_service_logs |
Hizmet günlük girişlerini al |
aiven_service_query_activity |
Bir hizmet için geçerli sorguları getir |
aiven_project_get_event_logs |
Proje olay günlüğü girişlerini al |
Kafka
| Araç | Açıklama |
|---|---|
aiven_kafka_topic_list |
Kafka konularını listele |
aiven_kafka_topic_create |
Bir Kafka konusu oluştur |
aiven_kafka_topic_get |
Kafka konu bilgilerini al |
aiven_kafka_topic_update |
Bir Kafka konusunu güncelle |
aiven_kafka_topic_delete |
Bir Kafka konusunu sil |
aiven_kafka_topic_message_list |
Bir Kafka konusundan mesajları oku |
aiven_kafka_topic_message_produce |
Bir Kafka konusuna mesaj üret |
aiven_kafka_connect_available_connectors |
Kullanılabilir bağlayıcı türlerini listele |
aiven_kafka_connect_list |
Çalışan bağlayıcıları listele |
aiven_kafka_connect_create_connector |
Bir bağlayıcı oluştur |
aiven_kafka_connect_edit_connector |
Bir bağlayıcıyı düzenle |
aiven_kafka_connect_get_connector_status |
Bağlayıcı durumunu al |
aiven_kafka_connect_pause_connector |
Bir bağlayıcıyı duraklat |
aiven_kafka_connect_resume_connector |
Bir bağlayıcıyı sürdür |
aiven_kafka_connect_restart_connector |
Bir bağlayıcıyı yeniden başlat |
aiven_kafka_connect_delete_connector |
Bir bağlayıcıyı sil |
aiven_kafka_schema_registry_subjects |
Şema Kayıt Defteri konularını listele |
aiven_kafka_schema_registry_subject_version_get |
Şema Kayıt Defteri konu sürümünü al |
PostgreSQL
| Araç | Açıklama |
|---|---|
aiven_pg_service_available_extensions |
Kullanılabilir uzantıları listele |
aiven_pg_service_query_statistics |
Sorgu istatistiklerini getir |
aiven_pg_bouncer_create |
Bir PgBouncer bağlantı havuzu oluştur |
aiven_pg_bouncer_update |
Bir PgBouncer bağlantı havuzunu güncelle |
aiven_pg_bouncer_delete |
Bir PgBouncer bağlantı havuzunu sil |
aiven_pg_read |
Salt okunur bir SQL sorgusu çalıştır |
aiven_pg_write |
Bir yazma SQL ifadesi çalıştır (INSERT, UPDATE, DELETE, CREATE TABLE, vb.) |
aiven_pg_optimize_query |
Yapay zeka destekli sorgu optimizasyonu (EverSQL) |
Uygulamalar
| Araç | Açıklama |
|---|---|
aiven_application_deploy |
Dockerize edilmiş bir uygulamayı Aiven'e dağıt |
aiven_application_redeploy |
Mevcut bir uygulamayı yeniden derle ve yeniden dağıt |
aiven_vcs_integration_list |
Bağlı VCS (GitHub) hesaplarını listele |
aiven_vcs_integration_repository_list |
Bir VCS entegrasyonu için depoları listele |
Dokümantasyon
| Araç | Açıklama |
|---|---|
aiven_docs_search |
Doğal dilde resmi Aiven dokümantasyonunda arama yapın. Yalnızca barındırılan sunucuda (https://mcp.aiven.live/mcp) kullanılabilir — kendi kendine barındırılan dağıtımlarda gösterilmez. |
Katkıda Bulunma
Geliştirme kurulumu, yerel olarak çalıştırma ve yeni araçlar ekleme için CONTRIBUTING.md dosyasına bakın.
Lisans
Kurulum
npx -y mcp-aivenKaynak: mcpservers.org