MCP SSH Server for Windsurf

Windsurf 向け MCP SSH サーバー

Windsurf IDE とシームレスに連携するよう設計された、Model Context Protocol（MCP）対応の SSH サーバーです。

機能

• SSH 操作に対応した完全な MCP プロトコルサポート
• 事前に定義した SSH サーバーへの自動接続
• SSH セッション用の対話型ターミナルインターフェース
• パスワード認証と鍵ベース認証の両方に対応
• MCP 連携を通じて Windsurf IDE と互換性があります

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

Windsurf の設定ページのエラー

以下の画像のように、Windsurf の設定ページで「Error: request failed. Check your configuration.」というエラーメッセージが表示される場合、このサーバーの実装では問題を解決するために必要な 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 で起動します。Web インターフェースには http://localhost:5050/ からアクセスできます。

Windsurf との連携

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

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

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