README.md•1.58 kB
# MCP SSH 工具服务器
一个基于MCP框架的SSH工具服务器，提供远程服务器管理功能。
## 功能特性
- 支持多服务器配置管理
- 提供SSH连接池管理
- 支持文件上传/下载（包括递归目录操作）
- 支持远程命令执行
- 可通过环境变量或代码配置服务器
## 安装
1. 使用uv安装Python 3.13+:
```bash
uv pip install --python=3.13
```
2. 安装项目依赖:
```bash
uv pip install "mcp[cli]"
uv pip install requests paramiko
```
3. (可选) 使用uv创建虚拟环境:
```bash
uv venv .venv
source .venv/bin/activate # Linux/Mac
.venv\Scripts\activate # Windows
```
4. 下载代码:
```bash
git clone https://github.com/nwnusun-cool/mcp-server-ssh-tools.git
```
## 配置
使用json文件配置服务器，示例：
```
{
"mcpServers": {
"ssh_sun": {
"command": "uv",
"args": [
"--directory",
"F:\\仓库\\产品\\mcp-server-ssh-tools",
"run",
"main.py"
],
"env": {
"SSH_IP": "192.168.2.127",
"SSH_USER": "root",
"SSH_PASSWORD": "123456",
"SSH_PORT": "22"
}
}
}
}
```
## 使用
## API接口
- `execute`: 执行远程命令
- `download_file`: 下载远程文件/目录
- `upload_file`: 上传本地文件/目录
- `list_directory`: 列出远程目录内容
- `test_connection`: 测试服务器连接
## 依赖
- mcp[cli]>=1.10.1
- paramiko>=3.5.1
- pyyaml>=6.0.2
- requests>=2.32.4
## 开发
```bash
# 安装开发依赖
pip install -e ".[dev]"
# 运行测试
pytest
```
## 许可证
MIT