SSH-based MCP server for remote command execution and file transfer. Credentials stay local.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Choose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Documentation Overview
2native-ssh-mcp
基于 SSH 的 MCP (Model Context Protocol) 服务器，Go 实现。让 AI 助手通过 MCP 协议远程执行命令、传输文件，SSH 凭据完全留在本地，不暴露给模型。
本项目参考了 classfang/ssh-mcp-server（TypeScript 版）的设计与实现，在其基础上用 Go 重写，并将文件操作整合为单个工具、支持进度通知。感谢原作者的开源贡献。
📖 文档
| 读者 | 文档 | 说明 |
|---|---|---|
| 🤖 AI Agent | docs/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 - 安全：命令白/黑名单、路径白名单、凭据隔离、配置权限检查
- 双传输：stdio / streamable HTTP daemon（引用计数、健康检查、Windows 一键自启）
- 认证兼容：密码/私钥/ssh-agent/Pageant/2FA、代理、算法协商（兼容老服务器）
完整特性列表见 docs/FEATURES.md。
🚀 快速上手
详细配置与部署步骤见上方两份指南。
License
ISC License（与上游一致，保留上游版权声明，见 LICENSE）
Related MCP Servers
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about 2native SSH MCP Server
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/2native-ssh-mcp-server)HTML Embed
<a href="https://allmcps.com/mcp/2native-ssh-mcp-server"><img src="https://allmcps.com/api/badge/2native-ssh-mcp-server?style=directory" alt="2native SSH MCP Server on AllMCPs" /></a>Technical Specs & Signals
CategoryDeveloper Tools
29Quality signal: Emerging · 29/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership10/20
Documentation & tools11/30
Adoption & activity1/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.