M2m MCP Server Ssh Server

🚀 MCP 服務器 SSH

MCP 服務器 SSH 是一款用於提供安全 SSH 訪問的工具，具備密鑰管理功能。它支持客戶端通過 SSH 協議連接服務器，還能借助配套的 HTTP 密鑰管理服務器，簡化客戶端公鑰的註冊流程。

🚀 快速開始

MCP 服務器 SSH 能讓你安全地進行 SSH 連接，並通過密鑰管理服務器簡化公鑰註冊。你可以按照以下步驟開始使用。

✨ 主要特性

• 提供安全的 SSH 訪問。
• 支持密鑰管理功能，可簡化客戶端公鑰註冊流程。
• 可選擇性運行 HTTP 密鑰管理服務器。
• 默認綁定到 localhost 提高安全性。
• 自動生成具有安全權限的密鑰。
• 支持客戶端 IP 地址白名單限制。

📦 安裝指南

使用命令行運行

uv run m2m-mcp-server-ssh-server --help

參數選項

⚠️ 重要提示

當綁定到所有接口（0.0.0.0）時，您的服務器將可以從能夠訪問您系統的任何機器訪問。請確保使用強身份驗證，並考慮使用防火牆等額外安全措施。

💻 使用示例

密鑰管理服務器

您可以選擇性地運行一個 HTTP 密鑰管理服務器來簡化客戶端密鑰註冊：

uv run m2m-mcp-server-ssh-server --run-key-server

這將啟動：

• SSH 服務器監聽 8022 端口
• 密鑰管理 HTTP 服務器監聽 8000 端口（默認僅限 localhost）

密鑰管理 API

密鑰管理服務器提供以下接口：

基礎用法

# 註冊客戶端公鑰
curl -X POST -H "Content-Type: application/json" \
  -d '{"client_pub_key": "ssh-rsa AAAA..."}' \
  http://localhost:8000/register

上述代碼展示瞭如何使用 curl 命令向密鑰管理服務器註冊客戶端公鑰。

高級用法

# 獲取服務器的公鑰
curl http://localhost:8000/server_pub_key

# 檢查服務器健康狀態
curl http://localhost:8000/health

上述代碼展示瞭如何使用 curl 命令獲取服務器的公鑰和檢查服務器的健康狀態。

接口詳情

1. POST /register - 註冊客戶端公鑰

   • 請求體：{"client_pub_key": "ssh-rsa AAAA..."}
   • 響應：{"status": "success"} 或錯誤信息

2. GET /server_pub_key - 獲取服務器的公鑰

   • 響應：{"server_pub_key": "ssh-ed25519 AAAA..."}

3. GET /health - 檢查服務器健康狀態

   • 響應：{"status": "healthy"}

🔧 技術細節

安全注意事項

• 默認綁定到 localhost（127.0.0.1）以提高安全性。
• 自動生成具有安全權限的密鑰（如果沒有提供）。
• 默認密鑰位置為 ~/.ssh/m2m_mcp_server_ssh_server。
• 私鑰使用 0644 權限進行保護。
• 支持客戶端 IP 地址白名單限制。

依賴項

• Python 3.8+
• pip 包管理器
• cryptography 庫（用於加密操作）

開發環境設置

git clone https://github.com/yourusername/mcp-server-ssh.git
cd mcp-server-ssh
pip install -r requirements.txt
python main.py --help

🤝 貢獻指南

提交代碼

1. Fork 項目倉庫。
2. 創建功能分支：git checkout -b feature/new-feature。
3. 提交更改：git commit -m "添加新功能"。
4. 推送到分支：git push origin feature/new-feature。
5. 創建 Pull Request。

開發規範

1. 遵循 PEP8 代碼風格指南。
2. 添加單元測試用例。
3. 確保文檔更新。
4. 提交前運行格式檢查：black .。

📄 許可證

本項目採用 MIT 許可證，詳見 LICENSE 文件。