MCP SSH 服务器 🚀
使用(工具/方法)在您的Windows电脑上管理Ubuntu/Linux服务器 自然语言这个MCP(模型上下文协议)服务器允许您通过在Claude Desktop或Cursor IDE中建立SSH连接,以对话的方式控制您的远程服务器。
______________________________________________________________________
TR:(土耳其语缩写,无具体含义,可理解为“土耳其语”或保持原样) 从您的Windows电脑连接到Ubuntu/Linux服务器 自然语言 来管理吧!这个MCP(模型上下文协议)服务器允许您通过SSH连接(如通过Claude Desktop或Cursor IDE)来语音控制您的远程服务器。
🎯 为什么是这个项目?
与其使用传统的SSH管理方式,您只需对AI助手说“连接到我的Ubuntu服务器并显示磁盘使用情况”,它就能帮您完成任务。借助MCP协议,AI会为您执行SSH命令,并实时将结果呈现给您。
✨ 特性
- 🔐 安全的SSH连接 - 基于密码的身份验证
- ⚡(闪电符号,常用于表示速度、活力或电力等) 实时输出 - 实时查看命令输出
- 🤖 机器人 人工智能集成 - Claude Desktop支持Cursor IDE
- 🎨(颜料、绘画相关的表情符号,可意译为“绘画”或“涂鸦”等,具体根据上下文确定) 自然语言控制 - 通过语音命令执行命令
- 📦 箱子/包裹 最小化安装 - 只需3个工具,零复杂度
📋 需求
- Node.js 18或更高版本 (下载)
- Claude Desktop(可译为“Claude桌面版”或保持原样,根据上下文判断是否需要具体翻译) (下载)
- 一个具有SSH访问权限的Linux/Ubuntu服务器
Node.js 安装
Windows:
- 从该地址下载LTS版本
- 下载的
.msi运行该文件 - 安装完成后,打开终端并
node --version夏天
macOS(苹果电脑操作系统):
# Homebrew ile
brew install node
# Veya resmi site'den indirinLinux(Ubuntu/Debian):
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs🚀 安装
自动安装(推荐)⭐
只需添加到您的配置文件中:
{
"mcpServers": {
"ssh": {
"command": "npx",
"args": [
"-y",
"git+https://github.com/mertcankaraoglu/local-mcp-ssh.git#main"
]
}
}
}要求:
- Node.js v18+(下载)
- Claude Desktop 或 Cursor IDE
手动安装
1. 下载项目
git clone https://github.com/mertcankaraoglu/local-mcp-ssh.git
cd local-mcp-ssh2. 加载依赖项
npm install3. 连接MCP
根据您使用的应用程序,执行以下步骤:
🖥️ 适用于Claude Desktop
Windows:
%APPDATA%\Claude\claude_desktop_config.json 打开并添加该文件:
{
"mcpServers": {
"ssh": {
"command": "node",
"args": ["C:\\Users\\KULLANICI_ADINIZ\\local-mcp-ssh\\index.js"]
}
}
}macOS/Linux:
~/Library/Application Support/Claude/claude_desktop_config.json 打开文件:
{
"mcpServers": {
"ssh": {
"command": "node",
"args": ["/tam/yol/local-mcp-ssh/index.js"]
}
}
}🎯 适用于 Cursor IDE
Windows:
%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json 打开文件:
{
"mcpServers": {
"ssh": {
"command": "node",
"args": ["C:\\Users\\KULLANICI_ADINIZ\\local-mcp-ssh\\index.js"]
}
}
}macOS/Linux:
~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json:
{
"mcpServers": {
"ssh": {
"command": "node",
"args": ["/tam/yol/local-mcp-ssh/index.js"]
}
}
}4. 重新启动应用程序
关闭并重新打开 Claude Desktop 或 Cursor。MCP 服务器将自动启动。
5. 测试安装
在 Claude Desktop 上试试这个命令:
"SSH bağlantısı test et - 192.168.1.100 IP'li sunucuya bağlan"如果MCP服务器正在运行,Claude会向您询问SSH连接参数。
💡 使用
现有工具
| 工具 | 说明 |
|---|---|
ssh_connect | 连接到SSH服务器 |
ssh_exec | 在远程服务器上运行命令 |
ssh_disconnect | 关闭SSH连接 |
示例对话
建立连接:
Siz: "192.168.1.100 IP'li Ubuntu sunucuma bağlan. Kullanıcı adı: ubuntu, şifre: mypassword"
Claude: [ssh_connect aracını kullanarak bağlanır]执行命令:
Siz: "Disk kullanımını göster"
Claude: [ssh_exec ile 'df -h' komutunu çalıştırır]
Siz: "Son 10 sistem logunu göster"
Claude: [ssh_exec ile 'tail -n 10 /var/log/syslog' çalıştırır]
Siz: "Docker container'larını listele"
Claude: [ssh_exec ile 'docker ps' çalıştırır]关闭连接:
Siz: "SSH bağlantısını kapat"
Claude: [ssh_disconnect aracını kullanır]🔧 技术细节
所使用的技术
- @modelcontextprotocol/sdk 翻译为中文是:“@模型上下文协议/SDK(软件开发工具包)” - MCP协议实现
- ssh2(Secure Shell 2,一种安全的远程登录协议) - SSH2 客户端库
米马里(注:此为音译,具体含义需根据上下文确定)
┌─────────────────┐
│ Claude/Cursor │
│ (AI Client) │
└────────┬────────┘
│ MCP Protocol
│ (stdio)
┌────────▼────────┐
│ MCP SSH Server │
│ (Bu Proje) │
└────────┬────────┘
│ SSH2
│
┌────────▼────────┐
│ Ubuntu Server │
└─────────────────┘🛡️ 安全提示
- ⚠️ 密码不应以明文形式存储在配置文件中,仅在运行时使用
- 🔒 SSH连接使用标准SSH2协议进行加密
- 💡 建议为生产环境使用基于SSH密钥的身份验证(将在未来版本中添加)
🗺️ 路线图
- \[ \] SSH密钥支持
- \[ \] 多服务器管理
- \[ \] SFTP文件传输
- \[ \] 端口转发
- \[ \] 保存/加载会话
🤝 贡献/参与
我们期待您的贡献!请不要犹豫,提交您的拉取请求。
- Fork edin
- 创建一个特性分支(
git checkout -b feature/amazing) - 提交 edin(
git commit -m 'feat: Add amazing feature') - 推一下(
git push origin feature/amazing) - 提交拉取请求(Pull Request)
📝 学士学位
MIT 许可证 - 详情请见 许可证 查看文件。
🙏 谢谢
- Anthropic(公司名,可译为“安萨洛普奇”或根据具体语境保留原名) - 为Claude的MCP协议
- 模型上下文协议 - 为了出色的文档
______________________________________________________________________
⭐ 如果你喜欢这个项目,别忘了点赞哦!
______________________________________________________________________
ENG - 英文文档
🎯 为何选择这个项目?
无需使用传统的SSH管理方式,您只需告诉您的AI助手“连接到我的Ubuntu服务器并显示磁盘使用情况”,即可轻松完成任务。得益于MCP协议,AI会为您执行SSH命令,并实时展示结果。
✨ 特点
- 🔐 安全的SSH连接 - 基于密码的身份验证
- ⚡(闪电符号,常用于表示速度、活力或警告等含义) 实时输出 - 立即查看命令输出
- 机器人 人工智能集成 - 支持Claude Desktop和Cursor集成开发环境(IDE)
- 🎨 表示“美术”或“绘画”的意思。 自然语言控制 - 通过语音执行命令
- 📦 表示“包裹”或“箱子”。 最小化设置 - 只需3个工具,零复杂度
📋 要求
- Node.js 版本 18 或更高版本
- Claude 桌面版或 Cursor 集成开发环境(IDE)
- 一个可访问SSH的Linux/Ubuntu服务器
🚀 安装
1. 克隆项目
git clone https://github.com/YOUR_USERNAME/local-mcp-ssh.git
cd local-mcp-ssh2. 安装依赖项
npm install3. 连接MCP(或“连接到MCP”)
根据您的申请,按照以下步骤操作:
🖥️ 适用于Claude桌面版
Windows:
开放 %APPDATA%\Claude\claude_desktop_config.json 并补充:
{
"mcpServers": {
"ssh": {
"command": "node",
"args": ["C:\\Users\\YOUR_USERNAME\\local-mcp-ssh\\index.js"]
}
}
}macOS/Linux:
开放 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"ssh": {
"command": "node",
"args": ["/full/path/local-mcp-ssh/index.js"]
}
}
}🎯 适用于 Cursor 集成开发环境 (IDE)
Windows:
开放 %APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json:
{
"mcpServers": {
"ssh": {
"command": "node",
"args": ["C:\\Users\\YOUR_USERNAME\\local-mcp-ssh\\index.js"]
}
}
}macOS/Linux:
~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json:
{
"mcpServers": {
"ssh": {
"command": "node",
"args": ["/full/path/local-mcp-ssh/index.js"]
}
}
}4. 重启应用程序
关闭并重新打开 Claude Desktop 或 Cursor。MCP 服务器将自动启动。
💡 使用方法
可用工具
| 工具 | 描述 |
|---|---|
ssh_connect | 建立到服务器的SSH连接 |
ssh_exec | 在远程服务器上执行命令 |
ssh_disconnect | 关闭SSH连接 |
示例对话
连接:
You: "Connect to my Ubuntu server at 192.168.1.100. Username: ubuntu, password: mypassword"
Claude: [Connects using ssh_connect tool]运行命令:
You: "Show disk usage"
Claude: [Executes 'df -h' command via ssh_exec]
You: "Show last 10 system logs"
Claude: [Executes 'tail -n 10 /var/log/syslog' via ssh_exec]
You: "List Docker containers"
Claude: [Executes 'docker ps' via ssh_exec]断开连接:
You: "Close SSH connection"
Claude: [Uses ssh_disconnect tool]🔧 技术细节
所使用的技术
- @modelcontextprotocol/sdk(可翻译为):@modelcontextprotocol(模型上下文协议)/sdk(软件开发工具包) - MCP协议实现
- ssh2(Secure Shell 2,一种安全的远程登录协议) - SSH2 客户端库
建筑学
┌─────────────────┐
│ Claude/Cursor │
│ (AI Client) │
└────────┬────────┘
│ MCP Protocol
│ (stdio)
┌────────▼────────┐
│ MCP SSH Server │
│ (This Project) │
└────────┬────────┘
│ SSH2
│
┌────────▼────────┐
│ Ubuntu Server │
└─────────────────┘🛡️ 安全注意事项
- ⚠️ 密码不会以明文形式存储在配置文件中,仅在运行时使用
- 🔒 SSH 连接使用标准 SSH2 协议进行加密
- 💡 对于生产环境,建议使用基于SSH密钥的身份验证(将在未来版本中添加)
🗺️ 路线图
- \[ \] SSH 密钥支持
- \[ \] 多服务器管理
- \[ \] SFTP文件传输
- \[ \] 端口转发
- \[ \] 会话保存/加载
🤝 贡献(或“参与贡献”)
我们欢迎您的贡献!请随时提交拉取请求。
- 分叉它
- 创建你的特性分支(
git checkout -b feature/amazing) - 提交您的更改(
git commit -m 'feat: Add amazing feature') - 推送至分支(
git push origin feature/amazing) - 提交一个拉取请求
📝 许可证
MIT 许可证 - 详见 许可证 详情请查阅文件。
🙏 致谢
- Anthropic(公司名,不直接翻译,保持原样) - 适用于Claude和MCP协议
- 模型上下文协议 - 为了卓越的文档(或:为了出色的文档说明)
______________________________________________________________________
⭐ 如果你喜欢这个项目,别忘了给它加星标哦!
