ssh-mcp-server: AI İş Akışları için Güvenli Uzaktan SSH

“ssh-mcp-server” MCP Sunucusu ne işe yarar?

ssh-mcp-server, AI asistanlarının ve Model Context Protocol (MCP) desteği olan diğer uygulamaların, standartlaştırılmış bir arayüz aracılığıyla uzaktan SSH komutları çalıştırmasını sağlayan köprü bir araçtır. Güvenli bir aracı olarak hareket ederek, AI asistanlarının SSH kimlik bilgilerini doğrudan AI modellerine ifşa etmeden uzaktaki sunucularda güvenle işlem yapmasını, komut çalıştırmasını ve sonuçları almasını mümkün kılar. Sunucu; şifre ve özel anahtar ile kimlik doğrulama (isteğe bağlı parola desteği dahil) gibi birden fazla güvenli SSH bağlantı yöntemini destekler. Ayrıca, kara liste/beyaz liste mekanizmalarıyla komut güvenliği kontrolü ve yerel-uzak sunucular arasında çift yönlü dosya transferi sağlar. ssh-mcp-server, geliştirme iş akışlarına sorunsuz entegre olacak şekilde tasarlanmıştır; geliştiricilere ve AI ajanlarına bakım, otomasyon ve dağıtım gibi görevler için uzaktaki sistemlere güçlü ve kontrollü erişim sunar.

Komut Listesi

Kullanılabilir dökümantasyonda açık bir komut şablonu bulunmamaktadır.

Kaynak Listesi

Kullanılabilir dosyalarda veya README’de açıkça belgelenmiş bir kaynak yoktur.

Araçlar Listesi

• execute-command
  Komut Çalıştırma Aracı: Uzaktaki sunucularda SSH komutları çalıştırır ve sonuçları alır.
• upload
  Dosya Yükleme Aracı: Yerel dosyaları, uzaktaki sunuculardaki belirlenen konumlara yükler.
• download
  Dosya İndirme Aracı: Uzaktaki sunuculardan, belirlenen yerel konumlara dosya indirir.

Bu MCP Sunucusunun Kullanım Alanları

• Uzaktan Sunucu Yönetimi
  Geliştiricilerin veya AI ajanlarının, uzaktaki sunucularda servisleri yeniden başlatmak, logları incelemek veya yazılım güncellemek gibi idari/bakım komutlarını güvenle çalıştırmasını sağlar.
• Otomatik Dağıtım
  Betikler veya AI iş akışları ile kod push etme, kurulum betiği çalıştırma veya uygulama yönetimi gibi işlemleri SSH üzerinden otomatikleştirir.
• Dosya Senkronizasyonu
  Çift yönlü dosya transferi desteğiyle, yapılandırma dosyalarını yüklemek veya uzaktaki sunuculardan log ve sonuçları indirmek kolaylaşır.
• Güvenlik Denetimi
  Beyaz liste/kara liste ile denetlenen komutların çalıştırılmasına izin vererek, sistemi riske atmadan güvenli denetim ve uyumluluk kontrolü yapılmasını sağlar.
• Kimlik Bilgisi İzolasyonu
  SSH kimlik bilgilerinin AI modele asla iletilmemesini sağlayarak, hassas ortamlarda güvenli işlem yapılmasına imkan tanır.

Nasıl kurulur?

Windsurf

1. Gereksinimler: Node.js ve npx’in kurulu olduğundan emin olun.
2. Yapılandırmayı Açın: Windsurf yapılandırma dosyanızı açın.
3. MCP Sunucusu Ekleyin: mcpServers nesnesine aşağıdaki JSON’u ekleyin:

   {
     "mcpServers": {
       "ssh-mpc-server": {
         "command": "npx",
         "args": [
           "-y",
           "@fangjunjie/ssh-mcp-server",
           "--host 192.168.1.1",
           "--port 22",
           "--username root",
           "--password pwd123456"
         ]
       }
     }
   }
   

4. Kaydedin ve Yeniden Başlatın: Dosyayı kaydedin ve Windsurf’u yeniden başlatın.
5. Kurulumu Doğrulayın: MCP arayüzü üzerinden basit bir SSH komutu çalıştırarak test edin.

Claude

1. Gereksinimler: Node.js ve npx kullanılabilir olmalı.
2. Yapılandırmayı Açın: Claude’un mcpServers ayarlarını açın.
3. MCP Sunucusu Ekleyin: Şu yapılandırmayı kullanın:

   {
     "mcpServers": {
       "ssh-mpc-server": {
         "command": "npx",
         "args": [
           "-y",
           "@fangjunjie/ssh-mcp-server",
           "--host 192.168.1.1",
           "--port 22",
           "--username root",
           "--privateKey ~/.ssh/id_rsa"
         ]
       }
     }
   }
   

4. Kaydedin ve Yeniden Başlatın: Değişiklikleri kaydedin ve Claude’u yeniden başlatın.
5. Kurulumu Doğrulayın: Claude’un MCP entegrasyonu üzerinden test komutu çalıştırın.

Cursor

1. Gereksinimler: Node.js ve npx kurulu olmalı.
2. Yapılandırmayı Düzenleyin: Cursor yapılandırma dizinine gidip ilgili dosyayı açın.
3. MCP Sunucusu Ekleyin: Şunu ekleyin:

   {
     "mcpServers": {
       "ssh-mpc-server": {
         "command": "npx",
         "args": [
           "-y",
           "@fangjunjie/ssh-mcp-server",
           "--host 192.168.1.1",
           "--port 22",
           "--username root",
           "--privateKey ~/.ssh/id_rsa",
           "--passphrase pwd123456"
         ]
       }
     }
   }
   

4. Cursor’ı Yeniden Başlatın: Kaydedin ve Cursor’ı yeniden başlatın.
5. Doğrulayın: MCP komut paletini kullanarak uzaktan SSH bağlantısını kontrol edin.

Cline

1. Gereksinimler: Node.js ve npx’in kurulu olduğundan emin olun.
2. Yapılandırmayı Açın: Cline yapılandırmasında mcpServers bölümünü düzenleyin.
3. MCP Sunucusu Ekleyin: Şunu ekleyin:

   {
     "mcpServers": {
       "ssh-mpc-server": {
         "command": "npx",
         "args": [
           "-y",
           "@fangjunjie/ssh-mcp-server",
           "--host 192.168.1.1",
           "--port 22",
           "--username root",
           "--password pwd123456",
           "--whitelist ^ls( .*)?,^cat .*,^df.*"
         ]
       }
     }
   }
   

4. Kaydedin ve Yeniden Başlatın: Yapılandırmayı kaydedip Cline’ı yeniden başlatın.
5. Bağlantıyı Test Edin: İzin verilen bir komut çalıştırarak doğrulayın.

API Anahtarlarını Güvenceye Alma

Kimlik bilgilerinin yapılandırma dosyalarında görünmesini önlemek için ortam değişkenlerini kullanın:

{
  "mcpServers": {
    "ssh-mpc-server": {
      "command": "npx",
      "args": [
        "-y",
        "@fangjunjie/ssh-mcp-server",
        "--host ${SSH_HOST}",
        "--port ${SSH_PORT}",
        "--username ${SSH_USER}",
        "--password ${SSH_PASSWORD}"
      ],
      "env": {
        "SSH_HOST": "192.168.1.1",
        "SSH_PORT": "22",
        "SSH_USER": "root",
        "SSH_PASSWORD": "pwd123456"
      }
    }
  }
}

Bu MCP Sunucusu Flow’larda Nasıl Kullanılır?

FlowHunt’ta MCP Kullanımı

MCP sunucularını FlowHunt iş akışınıza entegre etmek için önce flow’unuza MCP bileşeni ekleyin ve AI ajanınza bağlayın:

MCP bileşenine tıklayın ve yapılandırma panelini açın. Sistem MCP yapılandırması bölümünde, MCP sunucu bilgilerinizi şu JSON formatında girin:

{
  "ssh-mpc-server": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Yapılandırma tamamlandığında, AI ajanınız bu MCP’yi tüm fonksiyonları ve yetenekleriyle bir araç olarak kullanabilir. “ssh-mpc-server” ismini kendi MCP sunucu adınızla ve URL’yi de kendi adresinizle değiştirmeyi unutmayın.

Genel Bakış

Bizim Görüşümüz

ssh-mcp-server, güvenlik ve pratiklik odaklı, temel SSH işlevselliği sunan bir MCP sunucusudur. Araç seti; birçok geliştirme ve otomasyon senaryosu için kullanışlı, fakat gelişmiş kaynaklar, komut şablonları veya örnekleme desteği gibi özelliklerden yoksundur. Kurulum ve kullanım dökümantasyonu nettir. Genel olarak, MCP üzerinden güvenli SSH erişimi için sağlam ve uzmanlaşmış bir yardımcıdır.

MCP Puanı

PUAN: 5/10

ssh-mcp-server, güvenli SSH entegrasyonu ve temel araç sunumunda öne çıksa da; kaynak, komut şablonu desteği ile kök veya örnekleme özellikleri belgelememekte ve puanını ortalama tutmaktadır. Açık kaynak lisansı ve net kurulumu avantajdır; fakat kapsamlı olmaktan ziyade odaklı bir MCP çözümüdür.