2native SSH MCP Server

io.github.daidaiJ由 GitHub 帳號 daidaiJ 發布v1.7.0更新於 Oct 27, 2026

SSH-based MCP server for remote command execution and file transfer. Credentials stay local.

已驗證STDIO僅桌面雲端與基礎設施檔案與儲存開發者工具

概覽

AI 產生的概覽

在本機執行的 SSH MCP 伺服器，讓 AI 助理遠端執行指令、管理工作階段與傳輸檔案，憑證保留在本機。

可以做什麼
  • 列出已設定的 SSH 伺服器並選擇目標主機
  • 遠端執行指令，支援斷線後仍存活、可重新接上的背景長任務
  • 管理工作階段，包含延遲連線、keepalive 與依逾時清理遠端程序
  • 透過 SFTP 傳輸檔案，支援原子寫入、續傳、目錄遞迴、sha256 驗證與進度通知
  • 大量輸出寫入本機檔案，助理可直接讀取或搜尋，不必遠端重跑
適用情境
適合需要讓助理透過 SSH 操作遠端 Linux 或 Unix 主機、執行指令、檢視輸出並搬移檔案的情境，同時不把 SSH 憑證交給模型。也適用於經由跳板機存取內網機器的環境。
執行需求
以本機桌面程序執行（stdio，或可選的 HTTP 常駐服務），使用對應平台的安裝包，不需 Node.js 或 Python 執行環境。需要設定檔或環境變數提供 SSH 連線資訊與憑證，並能連線到目標主機網路。支援密碼、私鑰、ssh-agent、Pageant 與鍵盤互動式兩階段驗證。
安裝前請注意
助理可在遠端主機執行任意指令並寫入或刪除檔案；建議開啟可選的破壞性指令審批模式，並設定指令與路徑的白名單、黑名單。用戶端不支援 elicitation 時審批會直接放行。憑證存放於本機設定檔或環境變數，需留意檔案權限。稽核日誌寫入本機，可驗證是否遭竄改。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 2native SSH MCP Server，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

English

2native-ssh-mcp

[CI] [Release] [Go] [License] [SLSA] [MCP Registry]

[2native-ssh-mcp — Native Go SSH MCP, credentials stay local]

基于 SSH 的 MCP (Model Context Protocol) 服务器，Go 实现。让 AI 助手通过 MCP 协议远程执行命令、传输文件，SSH 凭据完全留在本地，不暴露给模型。

本项目参考了 classfang/ssh-mcp-server（TypeScript 版）的设计与实现，在其基础上用 Go 重写，并将文件操作整合为单个工具、支持进度通知。感谢原作者的开源贡献。

架构

[架构：AI Agent 经 MCP 调用本机 2native-ssh-mcp，再经 SSH 到达远端主机]

AI 助手只看到四个 MCP 工具；本机进程负责 SSH，凭据不会进入模型上下文。

📖 文档

读者文档说明
🤖 AI Agentdocs/AGENT_GUIDE.md省 token 版：工具参数、配置、安全模式、部署命令速查
👤 人类用户docs/HUMAN_GUIDE.md易读版：安全配置、快速开始、工具说明、参数速查、发布流程
🔍 特性详情docs/FEATURES.md完整特性列表与已知限制（英文版 .en.md）
🛠 开发与发布docs/DEVELOPMENT.md项目结构、构建测试、Release 与 MCP Registry 发布流程
🔐 安全SECURITY.md威胁模型、审批闸门、审计落盘策略与分级加固建议

各文档均为中文默认，同名 .en.md 为英文版。

✨ 核心特性

  • 四个工具：list-servers / execute-command / session / file-transfer；后台长任务是 execute-command 的 background: true 特殊模式，不是第五个工具
  • 远程执行：懒连接 + keepalive、超时按远端 PID 杀进程组、默认不分配 PTY、后台任务断连存活可重附着
  • 输出处理：ANSI 剥离、大输出落盘到本地（.ssh-mcp-out/），Agent 用 Read/Grep 查全文，不远程重跑
  • 文件传输：原子落盘、去重、断点续传、目录递归、sha256 校验、进度通知
  • 破坏性命令审批（可选）：approvalMode: "ask-destructive" 经 MCP elicitation 弹窗确认，内置分类器 + 用户扩展/豁免，灰色地带用户自定；客户端不支持时 fail-open
  • 防篡改审计日志：每条命令追加进 SHA-256 哈希链（JSONL），事后篡改可定位到行（audit-verify）；落盘策略批量/写穿可调 → 审计日志
  • 跳板机隧道：via（OpenSSH ProxyJump）经跳板 direct-tcpip 连内网，各跳独立认证、不转发 agent，exec/shell/SFTP 行为与直连一致 → 跳板机
  • 安全：命令白/黑名单、路径白名单、凭据隔离、配置权限检查
  • 双传输：stdio / streamable HTTP daemon（引用计数、健康检查、Windows 一键自启）
  • 认证兼容：密码/私钥/ssh-agent/Pageant/键盘交互 2FA（挑战弹窗到 MCP 客户端，无人值守用环境变量兜底）、代理、算法协商（兼容老服务器）→ 认证方式

[凭据隔离：SSH 密钥与密码留在本机进程，不会到达模型]

完整特性列表见 docs/FEATURES.md。

🚀 快速上手

bash
# 构建go build -o 2native-ssh-mcp.exe .
# stdio 模式（MCP 客户端拉起，凭据放 config.json 或环境变量）2native-ssh-mcp.exe --config-file config.json
# HTTP 常驻服务2native-ssh-mcp.exe start --config-file config.json --http-addr 127.0.0.1:8338

详细配置与部署步骤见上方两份指南。

License

ISC License（与上游一致，保留上游版权声明，见 LICENSE）

來源：README.md，提交 bb0adb9

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.7.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分