MCP SSH Server

MCP SSH サーバー

Model Context Protocol（MCP）向けの強力な SSH サーバー実装です。このサーバーは、SSH プロトコルを通じて安全なリモートコマンド実行とファイル操作を可能にし、パスワード認証と鍵ベース認証の両方をサポートします。

特長

• ✨ 安全な SSH 接続管理
• 🔑 パスワード認証と鍵ベース認証
• 💻 リモートコマンド実行
• 📁 ファイル操作（アップロード／ダウンロード）
• 📊 ファイル転送の進行状況の追跡
• 🔐 権限管理
• 📂 ディレクトリ操作
• 🚀 複数ファイルの一括転送
• 📝 詳細なログ記録

インストール

1. パッケージをインストールします：

npm install mcp-ssh

2. Claude のデスクトップ設定（claude_desktop_config.json）に追加します：

{
  "mcpServers": {
    "ssh": {
      "command": "node",
      "args": ["%APPDATA%/npm/node_modules/mcp-ssh/dist/server.js"],
      "env": {
        "SSH_PORT": "8889",
        "SSH_LOG_LEVEL": "info"
      }
    }
  }
}

使用方法

パスワード認証

$body = @{
    id = "test"
    host = "example.com"
    port = 22
    username = "user"
    password = "pass123"
} | ConvertTo-Json

Invoke-RestMethod -Uri "http://localhost:8889/connect" -Method Post -Body $body -ContentType "application/json"

鍵認証

$body = @{
    id = "test"
    host = "example.com"
    port = 22
    username = "user"
    privateKey = Get-Content ~/.ssh/id_rsa | Out-String
    passphrase = "optional-key-passphrase"  # if your key is protected
} | ConvertTo-Json

Invoke-RestMethod -Uri "http://localhost:8889/connect" -Method Post -Body $body -ContentType "application/json"

コマンドの実行

$execBody = @{
    id = "test"
    command = "ls -la"
} | ConvertTo-Json

Invoke-RestMethod -Uri "http://localhost:8889/exec" -Method Post -Body $execBody -ContentType "application/json"

ファイル操作

# Upload file
$uploadForm = @{
    file = Get-Item -Path "localfile.txt"
    remotePath = "/remote/path/file.txt"
}
Invoke-RestMethod -Uri "http://localhost:8889/upload/test" -Method Post -Form $uploadForm

# Download file
Invoke-RestMethod -Uri "http://localhost:8889/download/test?remotePath=/remote/path/file.txt" -Method Get -OutFile "downloaded.txt"

ディレクトリ操作

# List directory
Invoke-RestMethod -Uri "http://localhost:8889/ls/test?path=/remote/path" -Method Get

# Get connection status
Invoke-RestMethod -Uri "http://localhost:8889/status/test" -Method Get

開発

1. リポジトリをクローンします：

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

2. 依存関係をインストールします：

npm install

3. ビルドします：

npm run build

4. サーバーを起動します：

npm start

環境変数

• SSH_PORT：サーバーポート（デフォルト：8889）
• SSH_LOG_LEVEL：ログレベル（デフォルト：info）

コントリビューション

1. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

ライセンス

MIT