🚀 Linux MCP Toolkit - 革命性的Linux服务器管理工具

🎯 项目简介

💡 开发背景

在AI时代，开发者需要一个能够用自然语言管理Linux服务器的工具。传统的SSH命令行方式对非专业人士太复杂，现有工具又缺乏AI集成能力。

Linux MCP Toolkit 应运而生！这是一个专为 Claude Desktop、Cursor、Windsurf 等AI客户端设计的MCP服务器，让你能够：

🗣️ 用中文对话管理服务器："帮我看看nginx状态"
🤖 AI智能运维：自动分析系统问题并给出解决方案
⚡ 一键部署：3分钟完成从安装到使用的全流程

🔧 核心功能

功能模块	能力描述	使用场景
🌐 连接管理	SSH连接、会话保持、自动重连	远程服务器管理
⚡ 命令执行	单次命令、交互式会话、长时间任务	系统运维、部署
📁 文件操作	上传、下载、编辑、权限管理	代码部署、配置管理
🔧 服务控制	systemd服务管理、Docker容器操作	应用生命周期管理
📊 系统监控	实时资源监控、日志分析	性能优化、故障排查

🚀 部署指南

📋 环境要求

Python: 3.8+ (推荐3.10+)
操作系统: Windows/macOS/Linux (开发机)
目标服务器: 任何支持SSH的Linux系统
AI客户端: Claude Desktop、Cursor、Windsurf等支持MCP的客户端

📦 安装方式（3选1）

方式1：一键安装（推荐）

pip install linux-mcp-toolkit

方式2：UV安装（更快）

uv pip install linux-mcp-toolkit

方式3：开发版安装

git clone https://github.com/linux-mcp/linux-mcp-toolkit
cd linux-mcp-toolkit
pip install -e .

⚙️ 配置文件设置

1. 找到配置文件

操作系统	配置文件路径
Windows	`%APPDATA%/Claude/claude_desktop_config.json`
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

2. 基础配置（必做）

{
  "mcpServers": {
    "linux-mcp-toolkit": {
      "command": "uvx",
      "args": ["linux-mcp-toolkit"]
    }
  }
}

3. 安全配置方式（推荐）

方式A：SSH密钥认证（最安全）

{
  "mcpServers": {
    "linux-mcp-toolkit": {
      "command": "uvx",
      "args": ["linux-mcp-toolkit"],
      "env": {
        "HOST": "192.168.1.100",
        "PORT": "22",
        "USERNAME": "root",
        "KEY_FILE": "D:\\MCP\\linux.pem",
        "PASSPHRASE": "",
        "TIMEOUT": "30",
        "RETRY": "3"
      }
    }
  }
}

方式B：系统环境变量（次推荐）

{
  "mcpServers": {
    "linux-mcp-toolkit": {
      "command": "uvx",
      "args": ["linux-mcp-toolkit"],
      "env": {
        "HOST": "192.168.1.100",
        "PORT": "22",
        "USERNAME": "root",
        "PASSWORD": "$SSH_PASSWORD",
        "KEY_FILE": "$SSH_KEY_PATH",
        "TIMEOUT": "30",
        "RETRY": "3"
      }
    }
  }
}

方式C：密码认证（仅测试用）

{
  "mcpServers": {
    "linux-mcp-toolkit": {
      "command": "uvx",
      "args": ["linux-mcp-toolkit"],
      "env": {
        "HOST": "192.168.1.100",
        "PORT": "22",
        "USERNAME": "root",
        "PASSWORD": "your_password",
        "TIMEOUT": "30",
        "RETRY": "3"
      }
    }
  }
}

🔐 环境变量设置

Linux/macOS:

# 设置密码
export SSH_PASSWORD="your_secure_password"

# 设置密钥路径
export SSH_KEY_PATH="/home/user/.ssh/id_rsa"

# 验证设置
echo $SSH_PASSWORD
echo $SSH_KEY_PATH

Windows:

# 设置密码
set SSH_PASSWORD=your_secure_password

# 设置密钥路径
set SSH_KEY_PATH=C:\Users\youruser\.ssh\id_rsa

# 验证设置
echo %SSH_PASSWORD%
echo %SSH_KEY_PATH%

🛡️ 安全最佳实践

优先使用SSH密钥而非密码认证
设置正确的密钥权限：chmod 600 ~/.ssh/id_rsa
避免在配置文件中存储明文密码
使用系统环境变量管理敏感信息
定期轮换密钥提高安全性
为AI客户端创建专用用户，避免使用root
使用密钥密码保护私钥文件

🔧 验证安装

步骤1：测试包安装

python -c "import linux_mcp_toolkit; print('✅ 安装成功')"

步骤2：测试命令行

# 测试连接
linux-mcp-toolkit --host 192.168.1.100 --ping

# 执行简单命令
linux-mcp-toolkit --host 192.168.1.100 --command "uname -a"

步骤3：重启AI客户端

重启你的Claude Desktop/Cursor/Windsurf，开始使用！

📸 使用示例

🎯 场景1：系统信息查询

用户对话："帮我看看服务器的系统信息"

AI响应：

我来帮您查看服务器系统信息：

📊 **系统概览**
- 主机名: web-server-01
- 操作系统: Ubuntu 22.04.3 LTS
- 内核版本: 5.15.0-88-generic
- 架构: x86_64

💾 **资源使用**
- CPU: 2核心，当前使用率 15%
- 内存: 4GB，已使用 2.1GB (52%)
- 磁盘: 40GB，已使用 12GB (30%)
- 负载: 0.25, 0.18, 0.12

🌐 **网络状态**
- 公网IP: 203.0.113.45
- 内网IP: 192.168.1.100
- 网络延迟: 12ms

🚀 场景2：服务管理

用户对话："nginx服务好像有问题，帮我检查一下"

AI响应：

🔍 **Nginx状态检查**

📊 **服务状态**: active (running) ✅
📅 **运行时间**: 2天 14小时 36分钟
👥 **进程数**: 3个nginx进程
🌐 **监听端口**: 80, 443

📋 **配置文件检查**
✅ /etc/nginx/nginx.conf - 语法正确
✅ /etc/nginx/sites-enabled/ - 配置已启用

🚨 **发现的问题**: 
- 日志显示有404错误 (建议检查网站根目录)
- SSL证书将在15天后过期

💡 **建议操作**: 
1. 检查网站文件权限
2. 更新SSL证书
3. 重启nginx服务

📁 场景3：文件操作

用户对话："帮我在/var/www/html目录下创建一个测试文件"

AI响应：

📁 **文件操作完成**

✅ **创建文件**: /var/www/html/test.html
📋 **文件内容**:
```html
<!DOCTYPE html>
<html>
<head>
    <title>测试页面</title>
</head>
<body>
    <h1>Linux MCP Toolkit 测试成功！</h1>
    <p>当前时间: 2024-12-27 15:30:45</p>
</body>
</html>

🔗 访问地址: http://your-server-ip/test.html 📊 文件权限: 644 (rw-r--r--) 👤 所有者: www-data:www-data


### 🐳 场景4：Docker容器管理
**用户对话**："查看所有运行的容器"

**AI响应**：

🐳 Docker容器状态

📊 运行中的容器 (3个):

nginx-web (nginx:latest)
- 状态: ✅ Up 2 days
- 端口: 0.0.0.0:80->80/tcp
- 内存: 128MB / 512MB
mysql-db (mysql:8.0)
- 状态: ✅ Up 2 days (healthy)
- 端口: 3306/tcp
- 内存: 456MB / 1GB
redis-cache (redis:7-alpine)
- 状态: ✅ Up 2 days
- 端口: 6379/tcp
- 内存: 12MB / 256MB

📈 资源总计:

容器总数: 5 (运行中: 3, 已停止: 2)
总内存使用: 596MB / 1.77GB
总CPU使用: 8.5%


### ⚡ 场景5：实时日志监控
**用户对话**："实时监控nginx访问日志"

**AI响应**：

📊 开始监控nginx访问日志

# 实时日志输出 (按Ctrl+C停止)
tail -f /var/log/nginx/access.log

[15:35:12] 203.0.113.45 - - [27/Dec/2024:15:35:12 +0000] "GET / HTTP/1.1" 200 1234 "-" "Mozilla/5.0"
[15:35:13] 203.0.113.46 - - [27/Dec/2024:15:35:13 +0000] "GET /api/users HTTP/1.1" 200 567 "-" "curl/7.68.0"
[15:35:14] 203.0.113.47 - - [27/Dec/2024:15:35:14 +0000] "POST /login HTTP/1.1" 302 456 "https://example.com/login" "Mozilla/5.0"

# 统计信息
- 当前QPS: 15.3 requests/sec
- 2xx响应: 85%
- 4xx响应: 12%
- 5xx响应: 3%

🛠️ 故障排除

常见问题速查表

问题描述	解决方案	验证命令
连接失败	检查SSH服务、防火墙、用户名密码	`ssh user@host`
权限错误	确认用户权限、使用sudo	`sudo -l`
包导入失败	重新安装、检查Python路径	`pip show linux-mcp-toolkit`
AI客户端无响应	重启客户端、检查配置文件	查看客户端日志

🔍 调试模式

# 启用详细日志
linux-mcp-toolkit --debug --host 192.168.1.100 --command "uptime"

# 测试配置文件
linux-mcp-toolkit --config-test

🎉 3分钟快速上手

📦 安装 (30秒)
```
pip install linux-mcp-toolkit
```
⚙️ 配置 (60秒)
- 复制配置JSON到客户端配置文件
- 填入服务器信息
🔄 重启 (30秒)
- 重启你的AI客户端
🚀 使用 (60秒)
- 开始用自然语言管理服务器！

示例对话：

"帮我看看服务器状态"
"重启nginx服务"
"查看今天的日志"

📞 支持与反馈

GitHub: linux-mcp/linux-mcp-toolkit
问题反馈: 提交Issue
文档: 完整文档

⭐ 如果这个项目帮到了你，请给个Star！

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iflow_mcp_linux_mcp_toolkit-1.0.12.tar.gz (12.0 kB view details)

Uploaded Nov 19, 2025 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

iflow_mcp_linux_mcp_toolkit-1.0.12-py3-none-any.whl (12.2 kB view details)

Uploaded Nov 19, 2025 Python 3

File details

Details for the file iflow_mcp_linux_mcp_toolkit-1.0.12.tar.gz.

File metadata

Download URL: iflow_mcp_linux_mcp_toolkit-1.0.12.tar.gz
Upload date: Nov 19, 2025
Size: 12.0 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.6.9

File hashes

Hashes for iflow_mcp_linux_mcp_toolkit-1.0.12.tar.gz
Algorithm	Hash digest
SHA256	`5c469c605293c53534728feb9988c216001865af58417af783bc9afaed32682f`
MD5	`ba7b9a4f7c99508fd69caf9347501180`
BLAKE2b-256	`8e5f1a37251a858e9399c406d8435df10c4059e33f2ffb8192cfe96e4e495797`

See more details on using hashes here.

File details

Details for the file iflow_mcp_linux_mcp_toolkit-1.0.12-py3-none-any.whl.

File metadata

Download URL: iflow_mcp_linux_mcp_toolkit-1.0.12-py3-none-any.whl
Upload date: Nov 19, 2025
Size: 12.2 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.6.9

File hashes

Hashes for iflow_mcp_linux_mcp_toolkit-1.0.12-py3-none-any.whl
Algorithm	Hash digest
SHA256	`272ff27c976b04f44994daafd320f4e36478e232bbfb7ad07365b974d43d95ad`
MD5	`9ad186f279c07f2a002d1ebe4c80c6da`
BLAKE2b-256	`04fff66de6fadb5c24b87640b6794fa2d264421177ec1bd25b8b4fbdc6d1e686`

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

1.0.12 This release

Nov 19, 2025 2 files

iflow-mcp_linux-mcp-toolkit 1.0.12

🚀 Linux MCP Toolkit - 革命性的Linux服务器管理工具

🎯 项目简介

💡 开发背景

🔧 核心功能

🚀 部署指南

📋 环境要求

📦 安装方式（3选1）

方式1：一键安装（推荐）

方式2：UV安装（更快）

方式3：开发版安装

⚙️ 配置文件设置

1. 找到配置文件

2. 基础配置（必做）

3. 安全配置方式（推荐）

🔐 环境变量设置

🛡️ 安全最佳实践

🔧 验证安装

步骤1：测试包安装

步骤2：测试命令行

步骤3：重启AI客户端

📸 使用示例

🎯 场景1：系统信息查询

🚀 场景2：服务管理

📁 场景3：文件操作

🛠️ 故障排除

常见问题速查表

🔍 调试模式

🎉 3分钟快速上手

📞 支持与反馈

Project links

Key dates

1 maintainer

Credits

License

Requires

Tags

Classifiers

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

File details

File metadata

File hashes

Release history Release notifications | RSS feed