🚀 MCP Linux 实用工具插件

MCP Linux 实用工具插件功能强大，借助 MCP 协议，可对 Linux 系统的各类功能进行访问与控制。以下将详细介绍该插件的安装、配置及使用方法。

🚀 快速开始

MCP Linux 实用工具插件能让你通过 MCP 协议轻松访问和控制 Linux 系统。下面为你介绍如何快速开启使用之旅。

✨ 主要特性

• 功能丰富：涵盖系统工具、文件系统操作、网络配置和监控功能等多个模块。
• 高度可配置：可通过配置文件对端口、允许访问的路径、命令等进行灵活设置。
• 安全可靠：支持限制访问路径、限定网络域和命令执行安全等安全参数配置。

📦 安装指南

安装步骤

1. 获取代码

   git clone https://github.com/your-username/mcplinux.git
   cd mcplinux
   

2. 安装依赖
   • 对于 Python 3 环境：

     pip install -r requirements.txt
     

3. 启动插件
   • 启动 MCP 插件服务器：

     python3 server.py [--port PORT] [--config CONFIG_FILE]
     

     其中，--port 是可选的，默认为 5000；--config 是配置文件路径。
4. 配置插件
   • 创建或编辑 config.yml 文件：

     server:
       port: 5000
       host: 0.0.0.0
     
     filesystem:
       allowed_paths:
         - "/safe/directory"
         - "/another/safe/path"
     
     network:
       allowed_domains:
         - "example.com"
         - "another.example.org"
     
     command:
       enabled: true
       allowed_commands:
         - "ls"
         - "cat /etc/os-release"
       blocked_commands:
         - "rm"
         - "sudo"
       allow_sudo: false
       timeout: 30  # seconds
       output_limit: 1024  # bytes
     
     monitoring:
       interval: 60  # seconds
     

💻 使用示例

基础用法

python3 server.py --port 5000

这将在地址 http://localhost:5000 上启动服务器。

from mcpclient import MCPClient

client = MCPClient("localhost", 5000)
print(client.request("linux://system/info"))  # 获取系统信息

高级用法

系统工具

• 命令执行

  result = client.execute("ls /safe/directory")
  print(result)
  

  配置选项：

  command:
    enabled: true
    allowed_commands:
      - "ls"
      - "cat /etc/os-release"
    blocked_commands:
      - "rm"
      - "sudo"
    allow_sudo: false
    timeout: 30  # seconds
    output_limit: 1024  # bytes
  

文件系统操作

• 访问文件

  file_info = client.request("linux://fs/info/usr/local/bin/myfile")
  print(file_info)
  

• 读取目录内容

  dir_content = client.request(f"linux://fs/dir/{safe_path}")
  print(dir_content)
  

网络配置

• 获取网络接口状态

  network_stats = client.request("linux://network/interfaces")
  print(network_stats)
  

• 设置默认网关

  curl -X POST "http://localhost:5000/api/network/gateway" -d '{"gateway":"192.168.1.1"}'
  

监控功能

• 获取系统负载

  load_avg = client.request("linux://system/load")
  print(load_avg)
  

• 收集磁盘使用情况

  disk_usage = client.request("linux://system/disk")
  print(disk_usage)
  

📚 详细文档

示例：使用 MCP 客户端获取系统信息

from mcpclient import MCPClient

# 创建 MCP 客户端实例
client = MCPClient("localhost", 5000)

# 获取系统信息
system_info = client.request("linux://system/info")
print("System Information:")
print(system_info)

# 获取网络接口状态
network_interfaces = client.request("linux://network/interfaces")
print("\nNetwork Interfaces:")
print(network_interfaces)

# 获取磁盘使用情况
disk_usage = client.request("linux://system/disk")
print("\nDisk Usage:")
print(disk_usage)

示例：通过 API 修改网络设置

# 设置默认网关
curl -X POST "http://localhost:5000/api/network/gateway" -d '{"gateway":"192.168.1.1"}'

🔧 技术细节

该插件通过 MCP 协议实现对 Linux 系统的访问和控制。在配置方面，可通过 config.yml 文件对服务器端口、允许访问的文件路径、网络域、命令执行权限等进行详细设置。在安全方面，通过限制访问路径、限定网络域和命令执行安全等措施保障系统安全。

📄 许可证

MCP Linux 实用工具插件 项目在 MIT License 许可证下发布。详情请查看 LICENSE 文件。

⚠️ 重要提示

在使用该插件时，请务必根据实际情况合理配置安全参数，避免因配置不当导致系统安全风险。

💡 使用建议

建议在测试环境中先进行充分测试，熟悉插件的各项功能和配置方法后，再应用到生产环境中。