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
     

使用说明

基本用法

1. 启动插件服务器

   python3 server.py --port 5000
   

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

2. 通过 MCP 访问资源

   • 使用 MCP 客户端访问资源：

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

功能模块

系统工具

• 命令执行
  • 执行 shell 命令：

    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)
  

安全注意事项

配置安全参数

• 限制访问路径

  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

许可证

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

示例：使用 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 '{"