SSH MCP Sunucusu

SSH MCP Sunucusu, Linux ve Windows sistemleri için SSH kontrolünü açığa çıkaran ve LLM'lerin ile diğer MCP istemcilerinin SSH aracılığıyla shell komutlarını güvenli bir şekilde yürütmesini sağlayan yerel bir Model Context Protocol (MCP) sunucusudur.

İçerik

• Hızlı Başlangıç
• Özellikler
• Kurulum
• İstemci Kurulumu
• Test
• Sorumluluk Reddi
• Destek

Hızlı Başlangıç

• Yükleyin SSH MCP Sunucusu
• Yapılandırın SSH MCP Sunucusu
• Kurun MCP İstemcinizi (örn. Claude Desktop, Cursor, vb)
• Doğal dil aracılığıyla Linux veya Windows sunucunuzda uzak shell komutlarını çalıştırın

Özellikler

• SSH yeteneklerini açığa çıkaran MCP uyumlu sunucu
• Linux ve Windows sistemlerinde uzak shell komutlarını çalıştırma
• Şifre veya SSH anahtarı aracılığıyla güvenli kimlik doğrulama
• TypeScript ve resmi MCP SDK ile oluşturulmuş
• Yapılandırılabilir zaman aşımı koruması otomatik işlem iptal edilmesi ile
• Zarif zaman aşımı işleme - bağlantıları kapatmadan önce asılı kalmış işlemleri öldürmeyi dener

Araçlar

• exec: Uzak sunucuda shell komutu çalıştır

  • Parametreler:
    • command (gerekli): Uzak SSH sunucusunda çalıştırılacak shell komutu
    • description (opsiyonel): Bu komutun ne yapacağına dair isteğe bağlı açıklama (yorum olarak eklenir)
  • Zaman Aşımı Yapılandırması:

• sudo-exec: Shell komutunu sudo yükseltme ile çalıştır

  • Parametreler:
    • command (gerekli): Sudo kullanarak root olarak çalıştırılacak shell komutu
    • description (opsiyonel): Bu komutun ne yapacağına dair isteğe bağlı açıklama (yorum olarak eklenir)
  • Notlar:
    • Şifreli sudo için --sudoPassword ayarlanması gerekir
    • Startup sırasında --disableSudo bayrağı geçilirse devre dışı bırakılabilir (sudo erişimi gerekli değilse veya mevcut değilse)
    • Kalıcı root erişimi için --suPassword kullanmayı düşünün (bu bir root shell oluşturur)
    • Sunucu --disableSudo ile başlatılırsa araç hiç kullanılamaz
  • Zaman Aşımı Yapılandırması:
    • Zaman aşımı --timeout komut satırı argümanı aracılığıyla yapılandırılır (milisaniye cinsinden)
    • Varsayılan zaman aşımı: 60000ms (1 dakika)
    • Bir komut zaman aşımına uğradığında, sunucu bağlantıyı kapatmadan önce çalışan işlemi otomatik olarak iptal etmeye çalışır
  • Maksimum Komut Uzunluğu Yapılandırması:
    • Maksimum komut karakterleri --maxChars aracılığıyla yapılandırılır
    • Varsayılan: 1000
    • Sınır yok modu: --maxChars=none veya herhangi bir <= 0 değeri ayarlayın (örn. --maxChars=0)

Kurulum

1. Depoyu klonlayın:

   git clone https://github.com/tufantunc/ssh-mcp.git
   cd ssh-mcp
   

2. Bağımlılıkları yükleyin:

   npm install
   

İstemci Kurulumu

IDE'nizi veya Cursor, Windsurf, Claude Desktop gibi LLM'nizi bu MCP Sunucusunu kullanacak şekilde yapılandırabilirsiniz.

Gerekli Parametreler:

• host: Linux veya Windows sunucusunun Hostname'i veya IP'si
• user: SSH kullanıcı adı

İsteğe Bağlı Parametreler:

• port: SSH portu (varsayılan: 22)
• password: SSH şifresi (veya anahtar tabanlı kimlik doğrulama için key kullanın)
• key: Özel SSH anahtarının yolu
• sudoPassword: Sudo yükseltme şifresi (sudo ile komutlar çalıştırırken)
• suPassword: Su yükseltme şifresi (kalıcı root shell gerektiğinde)
• timeout: Komut yürütme zaman aşımı (milisaniye cinsinden) (varsayılan: 60000ms = 1 dakika)
• maxChars: command girişi için izin verilen maksimum karakter (varsayılan: 1000). Sınırı devre dışı bırakmak için none veya 0 kullanın.
• disableSudo: sudo-exec aracını tamamen devre dışı bırakmak için bayrak. Sudo erişimi gerekli olmadığında veya kullanılamadığında faydalıdır.

{
    "mcpServers": {
        "ssh-mcp": {
            "command": "npx",
            "args": [
                "ssh-mcp",
                "-y",
                "--",
                "--host=1.2.3.4",
                "--port=22",
                "--user=root",
                "--password=pass",
                "--key=path/to/key",
                "--timeout=30000",
                "--maxChars=none"
            ]
        }
    }
}

Claude Code

Bu MCP sunucusunu Claude Code'a claude mcp add komutu kullanarak ekleyebilirsiniz. Bu, Claude Code için önerilen yöntemdir.

Temel Kurulum:

claude mcp add --transport stdio ssh-mcp -- npx -y ssh-mcp -- --host=YOUR_HOST --user=YOUR_USER --password=YOUR_PASSWORD

Kurulum Örnekleri:

Şifre Kimlik Doğrulama ile:

claude mcp add --transport stdio ssh-mcp -- npx -y ssh-mcp -- --host=192.168.1.100 --port=22 --user=admin --password=your_password

SSH Anahtarı Kimlik Doğrulama ile:

claude mcp add --transport stdio ssh-mcp -- npx -y ssh-mcp -- --host=example.com --user=root --key=/path/to/private/key

Özel Zaman Aşımı ve Sınır Yok Karakter Modu ile:

claude mcp add --transport stdio ssh-mcp -- npx -y ssh-mcp -- --host=192.168.1.100 --user=admin --password=your_password --timeout=120000 --maxChars=none

Sudo ve Su Desteği ile:

claude mcp add --transport stdio ssh-mcp -- npx -y ssh-mcp -- --host=192.168.1.100 --user=admin --password=your_password --sudoPassword=sudo_pass --suPassword=root_pass

Kurulum Kapsamları:

Sunucu eklerken kapsamı belirtebilirsiniz:

• Yerel kapsam (varsayılan): Geçerli projede kişisel kullanım için

  claude mcp add --transport stdio ssh-mcp --scope local -- npx -y ssh-mcp -- --host=YOUR_HOST --user=YOUR_USER --password=YOUR_PASSWORD
  

• Proje kapsamı: Takımınızla .mcp.json dosyası aracılığıyla paylaşın

  claude mcp add --transport stdio ssh-mcp --scope project -- npx -y ssh-mcp -- --host=YOUR_HOST --user=YOUR_USER --password=YOUR_PASSWORD
  

• Kullanıcı kapsamı: Tüm projelerinizde kullanılabilir

  claude mcp add --transport stdio ssh-mcp --scope user -- npx -y ssh-mcp -- --host=YOUR_HOST --user=YOUR_USER --password=YOUR_PASSWORD
  

Kurulumu Doğrulayın:

Sunucuyu ekledikten sonra Claude Code'u yeniden başlatın ve Cascade'den bir komut çalıştırmasını isteyin:

"Can you run 'ls -la' on the remote server?"

Claude Code'da MCP hakkında daha fazla bilgi için resmi belgelere bakın.

Test

Bu MCP Sunucusunun görsel hata ayıklaması için MCP Inspector kullanabilirsiniz.

npm run inspect

Sorumluluk Reddi

SSH MCP Sunucusu MIT Lisansı altında sağlanmaktadır. Kendi sorumluluğunuzda kullanın. Bu proje, herhangi bir SSH veya MCP sağlayıcısı tarafından bağlı değildir veya onaylanmamıştır.

Katkıda Bulunma

Katkılara açığız! Daha fazla bilgi için lütfen Katkı Kılavuzumuza bakın.

Davranış Kuralları

Bu proje, herkes için hoş bir ortam sağlamak amacıyla Davranış Kurallarına uyar.

Destek

SSH MCP Sunucusu'nun faydalı olduğunu düşünüyorsanız depoyu yıldızlamayı veya katkıda bulunmayı düşünün! Pull istekleri ve geri bildirimler hoş geldiniz.