MCP Ssh Server

🚀 MCP SSH サーバー（Windsurf用）

Windsurf IDEとのシームレスな統合を目的として設計された、MCPプロトコルに対応したSSHサーバーです。

✨ 主な機能

• MCPプロトコルを完全にサポートしたSSH操作
• 事前定義されたSSHサーバーへの自動接続
• SSHセッション用のインタラクティブなターミナルインターフェースの提供
• パスワードとキーによる認証方式のサポート
• MCPを介したWindsurf IDEとの互換性

📚 詳細ドキュメント

よくある問題のトラブルシューティング

Windsurf設定ページのエラー

Windsurf設定ページで「エラー：リクエストが失敗しました。設定を確認してください。」というエラーメッセージが表示される場合（下図参照）、このサーバーの実装では必要なMCPプロトコルエンドポイントを提供しており、この問題を解決できます。

このエラーは通常、WindsurfがMCP SSHサーバーと正常に通信できない場合に発生し、主にエンドポイントの欠如やプロトコル互換性の問題が原因です。このリポジトリの実装には、Windsurfとの正しい統合に必要なすべてのエンドポイントが含まれています。

📦 インストール

前提条件

python >= 3.7
flask
paramiko

インストール手順

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

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

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

pip install -r requirements.txt

設定

Windsurf MCP設定ファイルでSSH接続設定を構成します：

{
  "mcpServers": {
    "ssh": {
      "command": "python3",
      "args": [
        "/path/to/app.py"
      ],
      "cwd": "/path/to/mcp-ssh-server",
      "protocol": "http",
      "host": "localhost",
      "port": 5050,
      "env": {
        "SSH_DEFAULT_HOST": "your_hostname",
        "SSH_DEFAULT_PORT": "22",
        "SSH_DEFAULT_USERNAME": "your_username",
        "SSH_DEFAULT_PASSWORD": "your_password"
      }
    }
  }
}

🔧 技術詳細

MCPエンドポイント

サーバーは以下のMCPプロトコルエンドポイントを実装しています：

• /alive - サーバーのヘルスチェック
• /list_sessions - アクティブなSSH接続の一覧表示
• /mcp/status - MCPサーバーの状態を確認
• /mcp/connect - SSHサーバーに接続
• /mcp/execute - SSHサーバー上でコマンドを実行
• /mcp/disconnect - SSHサーバーとの接続を切断
• /ssh/capabilities - SSHサーバーの機能一覧表示
• /ssh/sessions - アクティブなSSHセッションの一覧表示

💻 使用例

サーバーの起動

以下のコマンドを実行してサーバーを起動します：

python app.py

これにより、ポート5050でサーバーが起動します。http://localhost:5050/ からWebインターフェースにアクセスできます。

Windsurfとの統合

Windsurf MCP設定ファイルに適切な設定を追加することで、WindsurfがこのMCPサーバーを使用するようにします。

設定後も上記のエラーが発生する場合は、以下の手順を試してください：

1. MCP SSHサーバーを再起動します。
2. Windsurfアプリケーションを完全に再起動します。
3. サーバーが起動しており、http://localhost:5050/ からアクセスできることを確認します。
4. すべてのMCPエンドポイントが正しく応答することを確認します。