MCP Ssh Server

🚀 MCP SSH 服務器用於 Windsurf

這是一個與 MCP 協議兼容的 SSH 服務器，專為與 Windsurf IDE 實現無縫集成而設計。藉助該服務器，用戶能夠在 Windsurf 中順暢地進行 SSH 操作，提升開發效率。

🚀 快速開始

安裝和設置

先決條件

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"
      }
    }
  }
}

運行服務器

通過運行以下命令啟動服務器：

python app.py

這將啟動在端口 5050 上的服務器。您可以在 http://localhost:5050/ 訪問其網絡界面。

與 Windsurf 集成

通過向您的 Windsurf MCP 設置文件添加適當的配置，使 Windsurf 使用此 MCP 服務器。

如果配置完成後仍出現上述錯誤，請嘗試以下步驟：

1. 重新啟動 MCP SSH 服務器
2. 完全重啟 Windsurf 應用程序
3. 確認服務器已運行且可通過 http://localhost:5050/ 訪問
4. 檢查所有 MCP 端點是否正確響應

✨ 主要特性

• 完全支持 MCP 協議進行 SSH 操作
• 自動連接到預定義的 SSH 服務器
• 提供交互式終端界面用於 SSH 會話
• 支持基於密碼和密鑰的身份驗證
• 通過 MCP 集成與 Windsurf IDE 兼容

📚 詳細文檔

常見問題故障排除

Windsurf 設置頁面錯誤

如果在 Windsurf 設置頁面中出現錯誤消息，顯示“錯誤：請求失敗。檢查您的配置。”（如下圖所示），此服務器實現提供了必要的 MCP 協議端點以解決此問題。

該錯誤通常出現在 Windsurf 無法與 MCP SSH 服務器正常通信時，通常是由於缺少端點或協議兼容性問題導致的。此存儲庫中的實現包含了與 Windsurf 正確集成所需的全部必要端點。

MCP 端點

服務器實現了以下 MCP 協議端點：