金大哥 - mcp_lcu_server MCP 详情

article

README

🚀 MCP Linux 实用工具插件

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

🚀 快速开始

安装与配置

安装步骤

获取代码

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

安装依赖 若使用 Python 3 环境，执行以下命令：

pip install -r requirements.txt

启动插件 启动 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 上启动服务器。 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)

✨ 主要特性

支持通过 MCP 协议访问和控制 Linux 系统的多种功能。
提供丰富的功能模块，涵盖系统工具、文件系统操作、网络配置和监控功能。
可通过配置文件灵活配置插件的各项参数，保障系统安全。

📦 安装指南

具体安装步骤见上文“安装与配置”部分。

💻 使用示例

基础用法

from mcpclient import MCPClient

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

高级用法

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 客户端向服务器发送请求，服务器根据配置对请求进行处理并返回相应结果。

📄 许可证

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

⚠️ 重要提示

在配置 config.yml 文件时，需谨慎设置允许和禁止的命令，避免因配置不当导致系统安全问题。例如，禁止使用 rm 和 sudo 等危险命令，以防止误操作删除重要文件或执行高权限命令。

💡 使用建议

在使用该插件前，建议先在测试环境中进行充分测试，确保各项功能正常且配置符合需求。同时，定期检查配置文件，根据实际情况调整允许访问的路径、网络域和命令等参数。

mcp_lcu_server