Enhanced Linux MCP Toolkit with Interactive Shell Support

Navigation

Verified details

These details have been verified by PyPI
Maintainers
Avatar for chatflowdev from gravatar.com chatflowdev

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: MIT License
  • Author: Linux MCP Toolkit Team
  • Tags linux , ssh , mcp , system-administration , remote-management , interactive-shell
  • Requires: Python >=3.8
Classifiers
Report project as malware

Project description

🚀 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%

🛡️ 安全最佳实践

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

🔧 验证安装

步骤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个):

  1. nginx-web (nginx:latest)

    • 状态: ✅ Up 2 days
    • 端口: 0.0.0.0:80->80/tcp
    • 内存: 128MB / 512MB

  2. mysql-db (mysql:8.0)

    • 状态: ✅ Up 2 days (healthy)
    • 端口: 3306/tcp
    • 内存: 456MB / 1GB

  3. 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分钟快速上手

  1. 📦 安装 (30秒)

    pip install linux-mcp-toolkit

  2. ⚙️ 配置 (60秒)

    • 复制配置JSON到客户端配置文件
    • 填入服务器信息

  3. 🔄 重启 (30秒)

    • 重启你的AI客户端

  4. 🚀 使用 (60秒)

    • 开始用自然语言管理服务器！

示例对话：

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

📞 支持与反馈

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

Project details

Verified details

These details have been verified by PyPI
Maintainers
Avatar for chatflowdev from gravatar.com chatflowdev

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: MIT License
  • Author: Linux MCP Toolkit Team
  • Tags linux , ssh , mcp , system-administration , remote-management , interactive-shell
  • Requires: Python >=3.8
Classifiers

Release history Release notifications | RSS feed

This version

1.0.12

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 Source

Built Distribution

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

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

Uploaded Python 3

File details

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

File metadata

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

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.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page