Aiven

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:

1. Cloudflare Dönüştürme Kuralı — MCP kaynağına giden trafikte X-Edge-Auth (ve PG araçları için kullanılıyorsa X-Client-IP) ayarlayan bir kural ekleyin. Yapılandırdığınız gizli değeri not edin.
2. 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 veya false olarak bırakın; kaynağın hala trafiği kabul ettiğini doğrulayın.
3. 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 ve X-Edge-Auth olmadan doğrudan kaynak erişiminin reddedildiğini onaylayın.
4. Gizli anahtar döndürme — Cloudflare ve MCP_EDGE_AUTH_SECRET öğesini birlikte güncelleyin (veya kısa süreliğine EXTRA_PROTECTION=false ayarlayı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

Apache-2.0