M2m MCP Server Ssh Client

🚀 MCP 服務器 SSH 客戶端

MCP 服務器 SSH 客戶端是一個用於連接 MCP 服務器的工具，通過簡單的配置即可實現 SSH 連接，支持多種自定義選項，方便用戶使用。

🚀 快速開始

運行以下命令啟動 MCP 服務器 SSH 客戶端：

uvx mcp_server_ssh_client --host <主機名> --port <端口號>

📦 安裝指南

要安裝 MCP 服務器 SSH 客戶端及其依賴項，請運行以下命令：

pip install mcp-server-ssh-client

✨ 主要特性

• 靈活配置：支持通過命令行選項和自定義配置文件進行靈活的客戶端行為配置。
• 多密鑰支持：可指定不同的私鑰文件進行身份驗證。
• 日誌級別設置：支持設置不同的日誌級別，方便調試和監控。

📚 詳細文檔

高級配置

可以通過以下選項自定義客戶端行為：

• --host 或 -h：指定目標 SSH 服務器的主機名或 IP 地址。
• --port 或 -p：指定目標 SSH 服務器的端口號，默認為 22。
• --key-file 或 -k：指定用於身份驗證的私鑰文件路徑，默認為 ~/.ssh/id_ed25519。
• --known_hosts 或 -K：指定已知主機文件的路徑，默認為 ~/.ssh/known_hosts。
• --config 或 -c：指定自定義配置文件的路徑。
• --log-level 或 -l：設置日誌級別，可選值為 debug、info、warning、error、critical，默認為 warning。

詳細說明

使用默認 SSH 配置文件

MCP 服務器 SSH 客戶端默認使用標準的 SSH 配置文件：

• 私鑰文件：~/.ssh/id_ed25519
• 已知主機文件：~/.ssh/known_hosts

確保這些文件存在且具有適當的權限（600）。

使用自定義密鑰

如果你有多個 SSH 密鑰對，並希望使用特定的密鑰進行身份驗證，可以指定 --key-file 選項：

uvx mcp_server_ssh_client --host example.com --port 2222 --key-file /path/to/my_key

配置文件格式

你可以創建一個自定義配置文件（例如：~/.config/mcpx.json）來指定默認值：

{
  "host": "example.com",
  "port": 22,
  "key_file": "~/.ssh/id_ed25519",
  "known_hosts": "~/.ssh/known_hosts",
  "log_level": "warning"
}

⚠️ 安全注意事項

• 在生產環境中始終啟用主機密鑰驗證。
• 使用帶 passphrase 的 SSH 密鑰以增強安全性。
• 考慮為 MCP 連接使用專用的 SSH 密鑰。
• 設置適當的文件權限（600）以保護你的 SSH 密鑰文件。
• 在遠程服務器上使用具有有限權限的專用用戶。

❓ 常見問題排查

連接被拒絕

錯誤信息：

運行 MCP SSH 客戶端時出錯: [Errno 111] 連接被拒絕

解決方法：檢查主機名和端口號是否正確，並確保 SSH 服務正在運行。

驗證失敗

錯誤信息：

運行 MCP SSH 客戶端時出錯: 認證失敗

解決方法：檢查密鑰文件路徑。確保遠程服務器已安裝你的公鑰。

密鑰驗證失敗

錯誤信息：

運行 MCP SSH 客戶端時出錯: 私鑰文件無效或不可用

解決方法：確保私鑰文件存在且具有適當的權限（600）。嘗試使用 chmod 600 ~/.ssh/id_ed25519 來修復權限問題。

🛠️ 開發指南

安裝依賴

要開發 MCP 服務器 SSH 客戶端，首先安裝所需的依賴項：

pip install mcp-server-ssh-client[dev]

啟動調試模式

在開發或調試時，可以啟用 debug 日誌級別：

uvx mcp_server_ssh_client --host example.com --port 22 --log-level debug

🤝 文檔貢獻

如果你希望為這個項目貢獻文檔或代碼，請參考 GitHub 倉庫 中的 CONTRIBUTING.md 文件。

感謝你使用 MCP 服務器 SSH 客戶端！如果有任何問題或建議，請隨時通過 GitHub 提交 issue 或 pull request。