Which integrations are available for this server?

Allows managing Docker containers on remote servers by executing commands such as docker ps and docker ps -a via SSH. Provides tools for executing shell commands and managing files on remote Linux servers through an SSH connection. Facilitates remote administration of NGINX web servers, including editing configuration files and managing logs via SSH.

How do I use SSH MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@SSH MCP Server run 'docker ps' on the production server" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

SSH MCP Server

基于 Model Context Protocol (MCP) 的 SSH 服务器工具集，支持在远程服务器上执行命令和传输文件。

两种使用方式

本工具支持两种连接 SSH 服务器的方式：

方式一：直接参数（临时连接）

直接在工具调用中指定服务器信息，适合临时操作：

{ "tool": "ssh_execute_command", "arguments": { "host": "192.168.1.100", "port": 22, "username": "root", "password": "your_password", "command": "docker ps" } }

方式二：配置文件（推荐）

预先配置服务器信息，通过名称调用，适合频繁使用的服务器：

创建 ssh-mcp.config.json 配置文件
使用 server 参数指定服务器名称

{ "tool": "ssh_execute_command", "arguments": { "server": "production", "command": "docker ps" } }

优势：

无需每次输入密码
支持多服务器配置
通过 ssh_list_servers 工具查询可用服务器
Agent 可自主发现并使用服务器

安装

npm install npm run build

MCP 客户端配置

OpenCode

配置文件位置：C:\Users\<用户名>\.config\opencode\opencode.jsonc

{ "mcp": { "ssh-mcp": { "type": "local", "command": ["node", "path/to/ssh-mcp/dist/index.js"], "enabled": true } } }

Claude Code

配置文件位置：C:\Users\<用户名>\.claude\CLAUDE.json

{ "mcpServers": { "ssh-mcp": { "command": "node", "args": ["/path/to/ssh-mcp/dist/index.js"], "disabled": false } } }

Claude Desktop

配置文件位置：

Windows: %APPDATA%/Claude/claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{ "mcpServers": { "ssh-mcp": { "command": "node", "args": ["/path/to/ssh-mcp/dist/index.js"], "disabled": false } } }

SSH 配置文件

创建配置文件

{ "servers": { "production": { "host": "192.168.1.100", "port": 22, "username": "root", "password": "your_password", "timeout": 60000 }, "development": { "host": "192.168.1.50", "port": 2222, "username": "admin", "password": "dev_password" } }, "defaultServer": "development" }

配置文件位置（按优先级）

SSH_MCP_CONFIG 环境变量指定路径
当前项目目录 ssh-mcp.config.json
当前项目目录 .ssh-mcp-config.json
用户主目录 .ssh-mcp-config.json

配置文件参数说明

参数	必填	默认值	说明
`host`	是	-	SSH 服务器地址
`port`	否	22	SSH 端口
`username`	是	-	用户名
`password`	是	-	密码
`timeout`	否	30000	超时时间（毫秒）

使用示例

列出所有已配置的服务器

{ "tool": "ssh_list_servers" }

ssh_execute_command - 执行命令

使用配置文件中的服务器：

{ "tool": "ssh_execute_command", "arguments": { "server": "production", "command": "docker ps -a" } }

直接指定参数：

{ "tool": "ssh_execute_command", "arguments": { "host": "192.168.1.100", "port": 22, "username": "root", "password": "123", "command": "df -h", "response_format": "markdown" } }

指定工作目录：

{ "tool": "ssh_execute_command", "arguments": { "server": "production", "working_dir": "/var/www/app", "command": "npm run build" } }

ssh_upload_file - 上传文件

使用配置文件：

{ "tool": "ssh_upload_file", "arguments": { "server": "production", "local_path": "./config/app.yml", "remote_path": "/etc/myapp/config.yml" } }

直接指定参数：

{ "tool": "ssh_upload_file", "arguments": { "host": "192.168.1.100", "port": 22, "username": "root", "password": "123", "local_path": "./deploy.sh", "remote_path": "/opt/deploy/deploy.sh" } }

ssh_download_file - 下载文件

从服务器下载日志文件：

{ "tool": "ssh_download_file", "arguments": { "server": "production", "remote_path": "/var/log/app/error.log", "local_path": "./logs/error.log" } }

指定输出格式：

{ "tool": "ssh_download_file", "arguments": { "server": "development", "remote_path": "/etc/nginx/nginx.conf", "local_path": "./config/nginx.conf", "response_format": "json" } }

ssh_upload_directory - 上传目录

部署应用到服务器：

{ "tool": "ssh_upload_directory", "arguments": { "server": "production", "local_path": "./dist", "remote_path": "/var/www/myapp" } }

同步配置目录：

{ "tool": "ssh_upload_directory", "arguments": { "server": "development", "local_path": "./config", "remote_path": "/etc/myapp/config" } }

ssh_download_directory - 下载目录

下载服务器日志目录：

{ "tool": "ssh_download_directory", "arguments": { "server": "production", "remote_path": "/var/log/myapp", "local_path": "./logs" } }

备份项目目录：

{ "tool": "ssh_download_directory", "arguments": { "server": "production", "remote_path": "/opt/project", "local_path": "./backup/project" } }

工具列表

工具	说明
`ssh_list_servers`	列出所有已配置的服务器
`ssh_execute_command`	执行命令
`ssh_upload_file`	上传文件
`ssh_download_file`	下载文件
`ssh_upload_directory`	上传目录
`ssh_download_directory`	下载目录

ssh_execute_command 参数

参数	类型	必填	说明
`server`	string	否	服务器名称（配置文件）
`host`	string	否	SSH 服务器地址
`port`	number	否	SSH 端口，默认 22
`username`	string	否	用户名
`password`	string	否	密码
`timeout`	number	否	超时时间（毫秒）
`command`	string	是	要执行的命令
`working_dir`	string	否	工作目录
`response_format`	string	否	输出格式（markdown/json）

ssh_upload_file 参数

参数	类型	必填	说明
`server`	string	否	服务器名称（配置文件）
`host`	string	否	SSH 服务器地址
`port`	number	否	SSH 端口，默认 22
`username`	string	否	用户名
`password`	string	否	密码
`timeout`	number	否	超时时间（毫秒）
`local_path`	string	是	本地文件路径
`remote_path`	string	是	远程目标路径
`response_format`	string	否	输出格式（markdown/json）

ssh_download_file 参数

参数	类型	必填	说明
`server`	string	否	服务器名称（配置文件）
`host`	string	否	SSH 服务器地址
`port`	number	否	SSH 端口，默认 22
`username`	string	否	用户名
`password`	string	否	密码
`timeout`	number	否	超时时间（毫秒）
`remote_path`	string	是	远程文件路径
`local_path`	string	是	本地目标路径
`response_format`	string	否	输出格式（markdown/json）

ssh_upload_directory 参数

参数	类型	必填	说明
`server`	string	否	服务器名称（配置文件）
`host`	string	否	SSH 服务器地址
`port`	number	否	SSH 端口，默认 22
`username`	string	否	用户名
`password`	string	否	密码
`timeout`	number	否	超时时间（毫秒）
`local_path`	string	是	本地目录路径
`remote_path`	string	是	远程目标目录
`response_format`	string	否	输出格式（markdown/json）

ssh_download_directory 参数

参数	类型	必填	说明
`server`	string	否	服务器名称（配置文件）
`host`	string	否	SSH 服务器地址
`port`	number	否	SSH 端口，默认 22
`username`	string	否	用户名
`password`	string	否	密码
`timeout`	number	否	超时时间（毫秒）
`remote_path`	string	是	远程目录路径
`local_path`	string	是	本地目标目录
`response_format`	string	否	输出格式（markdown/json）

SSH MCP Server

SSH MCP Server

两种使用方式

方式一：直接参数（临时连接）

方式二：配置文件（推荐）

安装

MCP 客户端配置

OpenCode

Claude Code

Claude Desktop

SSH 配置文件

创建配置文件

配置文件位置（按优先级）

配置文件参数说明

使用示例

列出所有已配置的服务器

ssh_execute_command - 执行命令

ssh_upload_file - 上传文件

ssh_download_file - 下载文件

ssh_upload_directory - 上传目录

ssh_download_directory - 下载目录

工具列表

ssh_execute_command 参数

ssh_upload_file 参数

ssh_download_file 参数

ssh_upload_directory 参数

ssh_download_directory 参数

Resources

New MCP Servers

Latest Blog Posts

MCP directory API