Enables management of GCP resources including compute instances, storage buckets, and cloud functions, with support for cost analysis, monitoring metrics, and security compliance checks.
MCP Cloud Services Server
Comprehensive MCP (Model Context Protocol) server for cloud services management. Supports AWS, Azure, and GCP with resource management, cost analysis, monitoring, and security features.
🎯 Ne İşe Yarar?
MCP Cloud Services Server, AI asistanlarının (Cursor, Claude Desktop, vb.) cloud kaynaklarını yönetmesi, maliyetleri analiz etmesi, monitoring yapması ve güvenlik kontrolleri gerçekleştirmesi için kapsamlı bir MCP server'dır.
Temel Özellikler
☁️ Multi-Cloud Desteği: AWS, Azure, GCP desteği
📊 Resource Management: List, create, delete, start, stop operations
💰 Cost Analysis: Cost breakdown, trends, billing analysis
📈 Monitoring: Metrics, alarms, health checks
🔒 Security: Security scanning, compliance checks, encryption analysis
🔐 Credential Management: Secure credential storage and management
🚀 Nasıl Çalışır?
MCP Cloud Services Server, Model Context Protocol (MCP) standardını kullanarak AI asistanlarına cloud yönetim yetenekleri sağlar. Server, MCP protokolü üzerinden tool'ları expose eder ve AI asistanları bu tool'ları kullanarak cloud işlemlerini gerçekleştirebilir.
Mimari
Server, her cloud provider için adapter pattern kullanarak SDK çağrılarını yönetir. Credentials güvenli bir şekilde saklanır ve yönetilir.
📦 Kurulum
Gereksinimler
Node.js 18 veya üzeri
npm veya yarn
TypeScript (dev dependency)
Cloud provider credentials (AWS, Azure, or GCP)
Adımlar
Repository'yi klonlayın:
Bağımlılıkları yükleyin:
Projeyi derleyin:
Cloud Credentials Yapılandırın (aşağıdaki bölüme bakın)
Test edin:
🔐 Credentials Yapılandırması
Neden Credentials Gerekiyor?
Cloud provider'lar (AWS, Azure, GCP) güvenlik nedeniyle tüm API çağrılarında authentication gerektirir. Bu credentials, kimlik doğrulama ve yetkilendirme için kullanılır. Server, bu credentials'ları kullanarak cloud API'lerine güvenli bir şekilde bağlanır.
AWS Credentials
AWS için Access Key ID ve Secret Access Key gereklidir. Bu credentials, AWS IAM'de oluşturulur ve gerekli izinlere sahip olmalıdır.
Yöntem 1: Environment Variables (Önerilen)
Yöntem 2: AWS Credentials Dosyası
Yöntem 3: MCP Config İçinde
Gerekli IAM İzinleri:
ec2:DescribeInstances,ec2:StartInstances,ec2:StopInstancess3:ListBuckets,s3:GetBucketLocationlambda:ListFunctions,lambda:GetFunctionrds:DescribeDBInstancescloudwatch:GetMetricStatisticsce:GetCostAndUsage
Azure Credentials
Azure için Service Principal (Client ID, Client Secret, Tenant ID) veya Azure CLI login gereklidir. Ayrıca Subscription ID zorunludur.
Yöntem 1: Environment Variables
Yöntem 2: Azure CLI Login (En Kolay)
Yöntem 3: MCP Config İçinde
Service Principal Oluşturma:
Gerekli RBAC İzinleri:
Reader(kaynakları listeleme için)Virtual Machine Contributor(VM yönetimi için)Storage Account Contributor(storage yönetimi için)
GCP Credentials
GCP için Service Account JSON dosyası veya gcloud CLI gereklidir. Ayrıca Project ID zorunludur.
Yöntem 1: Service Account JSON (Önerilen)
Yöntem 2: gcloud CLI
Yöntem 3: MCP Config İçinde
Service Account Oluşturma:
GCP Console → IAM & Admin → Service Accounts
Create Service Account
Grant roles:
Compute Viewer,Storage Viewer,Cloud Functions ViewerCreate JSON key ve indir
Gerekli IAM Rolleri:
Compute Viewer(compute instance'ları görüntüleme)Storage Viewer(storage bucket'ları görüntüleme)Cloud Functions Viewer(function'ları görüntüleme)Monitoring Viewer(metrics için)Billing Account Viewer(cost analysis için)
📦 MCP Client'lara Kurulum
Cursor IDE
1. MCP Config Dosyasını Oluştur/Düzenle
Windows:
macOS/Linux:
Workspace-specific (Önerilen):
2. Config İçeriği
3. Cursor'u Yeniden Başlatın
Claude Desktop
1. MCP Config Dosyasını Oluştur/Düzenle
Windows:
macOS:
Linux:
2. Config İçeriği
Diğer MCP Client'lar
Herhangi bir MCP protokolü destekleyen client için, server'ı stdio transport ile başlatın:
🛠️ Kullanım
MCP Client'larda Kullanım
MCP server kurulduktan sonra, client'ınızın chat arayüzünde doğal dil komutları kullanarak cloud işlemlerini gerçekleştirebilirsiniz.
Örnek Kullanımlar
AWS:
Azure:
GCP:
Cost Analysis:
Monitoring:
Security:
📋 MCP Tools (26 Araç)
AWS Tools (6)
aws_list_ec2_instances- EC2 instance'ları listeleaws_list_s3_buckets- S3 bucket'ları listeleaws_list_lambda_functions- Lambda function'ları listeleaws_list_rds_instances- RDS instance'ları listeleaws_start_ec2_instance- EC2 instance başlataws_stop_ec2_instance- EC2 instance durdur
Azure Tools (2)
azure_list_virtual_machines- Virtual machine'leri listeleazure_list_storage_accounts- Storage account'ları listele
GCP Tools (3)
gcp_list_compute_instances- Compute instance'ları listelegcp_list_storage_buckets- Storage bucket'ları listelegcp_list_cloud_functions- Cloud function'ları listele
Resource Management Tools (5)
list_resources- Tüm cloud kaynaklarını listeleget_resource- Kaynak detaylarını getirstart_resource- Kaynağı başlatstop_resource- Kaynağı durdurdelete_resource- Kaynağı sil (dikkatli kullanın)
Cost Analysis Tools (3)
analyze_costs- Maliyet analizi yapget_cost_by_service- Servis bazlı maliyet dökümüestimate_monthly_cost- Aylık maliyet tahmini
Monitoring Tools (3)
get_metrics- Resource metrics'lerini getirlist_alarms- Monitoring alarm'larını listeleget_resource_health- Resource health durumunu kontrol et
Security Tools (4)
scan_security_issues- Güvenlik açıklarını taracheck_compliance- Compliance kontrolü yapanalyze_permissions- IAM permission analizicheck_encryption- Encryption durumunu kontrol et
📁 Proje Yapısı
🔧 Geliştirme
Development Modu
Build
Test
🔒 Güvenlik
Credentials güvenli saklanır (~/.cloud-services-mcp/credentials.json)
Environment variables desteği
Input validation ve sanitization
Error handling
Secure credential management
Önemli: Credentials'ları asla kod içine hardcode etmeyin. Her zaman environment variables veya güvenli credential store kullanın.
📊 Çıktı Formatları
JSON - Structured data responses
Markdown - Raporlar ve dokümantasyon
Text - Plain text output
🤝 Katkıda Bulunma
Fork edin
Feature branch oluşturun (
git checkout -b feature/amazing-feature)Commit edin (
git commit -m 'Add amazing feature')Push edin (
git push origin feature/amazing-feature)Pull Request açın
📄 Lisans
MIT License - Detaylar için LICENSE dosyasına bakın.
🔗 MCP Client Desteği
Bu MCP server aşağıdaki client'lar ile uyumludur:
✅ Cursor IDE - Tam destek
✅ Claude Desktop - Tam destek
✅ Anthropic API - MCP protokolü üzerinden
✅ Diğer MCP Client'lar - Standart MCP protokolü destekleyen tüm client'lar
🙏 Teşekkürler
Model Context Protocol - MCP standardı için
AWS SDK - AWS desteği için
Azure SDK - Azure desteği için
Google Cloud SDK - GCP desteği için
📞 İletişim
Sorularınız veya önerileriniz için issue açabilirsiniz.
⭐ Bu projeyi beğendiyseniz yıldız vermeyi unutmayın!
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables AI assistants to manage multi-cloud resources (AWS, Azure, GCP) including resource operations, cost analysis, monitoring metrics, and security compliance checks through natural language commands.