Aiven

Aiven MCP Sunucusu

Aiven bulut veri platformu için bir Model Context Protocol (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 ajanları, istemlerinizi yorumlamalarına dayanarak yıkıcı eylemler (veritabanlarını silme, hizmetleri silme, 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 Ajanı Güvenliği: Yapay zeka ajanlarının sizin adınıza işlem yapabilmesi için erişim kimlik bilgilerine (veritabanı bağlantı dizeleri, akış belirteçleri) ihtiyacı olabilir. Ajanınızın ne yaptığını, özellikle üretim ortamlarında, gözden geçirin. Kuruluşunuzun güvenlik politikalarını izleyin ve yapay zeka ajanlarına hassas kaynaklara erişim vermeden önce bir risk değerlendirmesi yapın.

Hızlı Başlangıç

Seçenek 1: Uzak (Aiven tarafından barındırılan)

MCP sunucusu https://mcp.aiven.live/mcp adresinde barındırılmaktadır. MCP istemciniz sizden Aiven üzerinde yetkilendirme yapmanızı isteyecektir.

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 ajanınıza sunulan araç yüzeyini azaltın. Yalnızca Aiven hizmetlerinin bir alt kümesiyle çalıştığınızda ve ajanı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, opensearch. Tüm araçları açıkça yüklemek için all kullanın (parametreyi atlamakla aynıdır). all diğer kapsamlarla birleştirilemez. opensearch, kafka veya pg ile aynı kuralları izler (çekirdek artı OpenSearch kategorisi araçları); henüz OpenSearch'e özgü araçlar yoktur, bu nedenle şu anda yalnızca çekirdeği sunar.

{
  "mcpServers": {
    "aiven-mcp": {
      "url": "https://mcp.aiven.live/mcp?services_scope=kafka"
    }
  }
}

read_only ile de birleştirebilirsiniz:

https://mcp.aiven.live/mcp?services_scope=pg&read_only=true

Salt Okunur Modda Yazma İstisnaları (Uzak)

read_only=true olduğunda, belirli yazma araçlarını yeniden etkinleştirmek için ?write_allowlist= ekleyin ve diğer her şeyi salt okunur tutun. Çoğunlukla okuma erişimi isteyip yine de tek bir yazma eylemine izin vermeniz gerektiğinde, örneğin Kafka konuları oluşturmak gibi durumlarda kullanışlıdır. Birden fazla 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

Pazaryeri Müşterileri (Uzak)

Aiven'e bir bulut pazaryeri aracılığıyla abone olduysanız, oturum açmanın doğru konsolu kullanması için pazaryerinizi bir yol segmenti olarak ekleyin:

Pazaryeri	Yol segmenti
AWS Marketplace	https://mcp.aiven.live/mcp/aws
Azure Marketplace	https://mcp.aiven.live/mcp/azure
Google Cloud Marketplace	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ğlamanız gerekir. 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 Settings > MCP Servers
• 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 portunu 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ı sunmak için true olarak ayarlayın
AIVEN_SERVICES_SCOPE	Hayır	--	Sunulacak virgülle ayrılmış kapsamlar (ör. kafka, pg,kafka veya all). Geçerli: all, core, pg, kafka, application, integrations, opensearch. Kapsamlı hizmet türleri için core örtük olarak dahil edilir. opensearch henüz özel araçlara sahip değildir (OpenSearch araçları eklenene kadar yalnızca çekirdek). Değişkeni atlamak veya all olarak ayarlamak tüm araçları yükler.
AIVEN_ALLOW_SECRETS	Hayır	false	Konuşmaya canlı kimlik bilgileri (parolalar, bağlantı URI'leri, sertifikalar) döndüren aiven_service_connection_info aracını sunmak 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 taşıma) üzerinde taşıyıcı belirteç başına pencere başına maksimum istek sayısı. İ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	HTTP dağıtımlarında GET /health hariç her istekte geçerli bir X-Edge-Auth başlığı gerektirmek için true olarak ayarlayın. Aşağıdaki Edge koruma kullanıma alma bölümüne bakın.
MCP_EDGE_AUTH_SECRET	EXTRA_PROTECTION=true olduğunda	--	Paylaşılan gizli anahtar; Cloudflare'in Transform Rules aracılığıyla X-Edge-Auth olarak enjekte ettiği değerle eşleşmelidir.

Uzak (HTTP) modda AIVEN_TOKEN gerekli değildir. MCP istemciniz belirtecinizi her istekte Bearer belirteci olarak gönderir.

Üretim HTTP trafiği iki katmanda hız sınırlamasına tabidir: Cloudflare istemci IP'si başına bir sınır uygular (Cloudflare kontrol panelinde yapılandırılır) ve bu sunucu POST /mcp üzerinde taşıyıcı belirteç başına MCP_HTTP_RATE_LIMIT_* uygular.

Edge koruma kullanıma alma

EXTRA_PROTECTION=true olduğunda, MCP_EDGE_AUTH_SECRET ile Cloudflare'in X-Edge-Auth olarak enjekte ettiği değer arasındaki herhangi bir uyuşmazlık her isteğin 403 döndürmesine neden olur (GET /health hariç). Her iki değer de bağlantının karşıt taraflarındaki ortam/yapılandırmadır, bu nedenle tek kurtarma yolu gizli anahtarı düzeltip yeniden dağıtmak veya Cloudflare'i güncellemektir.

Bu sırayla etkinleştirin:

1. Cloudflare Transform Rule — 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 anahtar değerini not edin.
2. MCP_EDGE_AUTH_SECRET — Sunucuyu bu ortam değişkeni Transform Rule ile aynı gizli anahtara ayarlanmış olarak dağıtın. Şimdilik EXTRA_PROTECTION değerini ayarlamadan bırakın veya false yapın; kaynağın hâlâ trafiği kabul ettiğini doğrulayın.
3. EXTRA_PROTECTION=true — Yalnızca 1–2. adımlar canlı ve eşleşmiş olduktan 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 doğrulayın.
4. Gizli anahtar rotasyonu — Cloudflare ve MCP_EDGE_AUTH_SECRET değerlerini 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 bir tarafı asla tek başına döndürmeyin.

Başlangıçta EXTRA_PROTECTION=true varsa ve MCP_EDGE_AUTH_SECRET eksikse, süreç hemen bir hatayla çıkar.

Reddetmeler devam ettiği sürece, 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 gizli anahtar uyuşmazlığı reddedilen her istek için bir satır olmadan günlüklerde 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ğiyle planları listele
aiven_service_type_get	Bir hizmet türü için varsayılan ve kullanılabilir motor sürümlerini al
aiven_service_plan_pricing	Belirli bir bulutta bir plan için fiyatlandırma 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 girdilerini al
aiven_service_query_activity	Bir hizmet için geçerli sorguları getir
aiven_project_get_event_logs	Proje olay günlüğü girdilerini 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	Schema Registry konularını listele
aiven_kafka_schema_registry_subject_version_get	Schema Registry 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 deyimi ç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_create	Bir Containerfile/Dockerfile uygulaması oluştur ve başlangıçta dağıt; hizmet zaten varsa 409 döndürür
aiven_application_redeploy	Hizmet yapılandırmasını değiştirmeden mevcut bir uygulamayı yapılandırılmış deposundan yeniden derle
aiven_vcs_integration_initialize	Bir GitHub hesabını bağlamak için tarayıcı tabanlı akışı başlat
aiven_vcs_integration_list	Bağlı VCS (GitHub) hesaplarını listele
aiven_vcs_integration_repository_list	Bir VCS entegrasyonu için depoları listele
aiven_vcs_integration_repository_branch_list	Depo dallarını ve bunların geçerli commit SHA'larını listele
aiven_vcs_integration_repository_container_manifest_files_list	Aday Containerfile, Dockerfile ve Compose manifestlerini bul
aiven_vcs_integration_repository_scan_container_manifest	Bir Containerfile, Dockerfile veya bir Compose dosyasının desteklenen bölümlerinden aday Aiven hizmet yapılandırmaları türet

Belgeler

Araç	Açıklama
aiven_docs_search	Resmi Aiven belgelerinde doğal dilde arama yapın. Yalnızca barındırılan sunucuda (https://mcp.aiven.live/mcp) kullanılabilir — kendi barındırdığınız dağıtımlarda sunulmaz.

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