MCP Linux 通用工具服务器

Model Context Protocol (MCP) Linux 通用工具 (LCU) 服务器是一个基于 Python 的服务器，它通过 Model Context Protocol 提供对各种 Linux 系统操作和信息的访问。

功能特性

• CPU 操作: CPU 信息、使用率、负载平均值等。
• 内存操作: 内存和交换空间信息、使用统计。
• 进程/线程操作: 进程列表、信息和管理。
• 存储操作: 磁盘、卷和分区信息。
• 文件系统操作: 文件创建、删除、更新和信息。
• 硬件操作: 硬件检测和信息。
• 网络操作: 接口信息、连接性测试和数据传输。
• 监控操作: 系统状态监控和健康检查。

安装

前提条件

• Python 3.10 或更高版本
• Linux 操作系统

安装步骤

1. 克隆仓库:

   git clone https://github.com/yourusername/mcp_lcu_server.git
   cd mcp_lcu_server
   

2. 安装包:

   pip install -e .
   

配置

服务器可以使用 YAML 配置文件进行配置。 默认情况下，它会在以下位置查找配置文件：

• ./config.yaml
• ./config/config.yaml
• /etc/mcp-lcu-server/config.yaml
• ~/.config/mcp-lcu-server/config.yaml

您还可以使用 --config 命令行选项指定自定义配置文件路径。

配置文件示例

server:
  name: mcp-lcu-server
  transport: both  # stdio, sse, 或 both
  port: 8000
  host: 127.0.0.1

monitoring:
  enabled: true
  interval: 30  # 秒
  metrics:
    - cpu
    - memory
    - disk
    - network

filesystem:
  allowed_paths:
    - /
  max_file_size: 10485760  # 10MB

network:
  allow_downloads: true
  allow_uploads: true
  max_download_size: 104857600  # 100MB
  max_upload_size: 10485760  # 10MB
  allowed_domains:
    - "*"  # 允许所有域名

process:
  allow_kill: false
  allowed_users: []

使用

启动服务器

您可以使用命令行界面启动服务器：

mcp-lcu-server [OPTIONS]

可用选项：

• --config, -c: 配置文件的路径
• --transport, -t: 传输类型 (stdio, sse, 或 both)
• --port, -p: SSE 传输的端口
• --host, -h: SSE 传输的主机
• --debug, -d: 启用调试日志

传输类型

服务器支持以下传输类型：

• stdio: 标准输入/输出传输
• sse: 服务器发送事件传输

示例

使用 stdio 传输启动服务器：

mcp-lcu-server --transport stdio

使用 SSE 传输在端口 8000 上启动服务器：

mcp-lcu-server --transport sse --port 8000

使用两种传输方式启动服务器：

mcp-lcu-server --transport both

API 文档

工具

服务器提供各种用于与 Linux 系统交互的工具：

CPU 工具

• get_cpu_info: 获取详细的 CPU 信息
• get_cpu_usage: 获取 CPU 使用百分比
• get_load_average: 获取系统负载平均值
• analyze_cpu_performance: 分析 CPU 性能

内存工具

• get_memory_info: 获取详细的内存信息
• get_memory_usage: 获取内存使用情况
• get_swap_info: 获取交换空间信息
• analyze_memory_performance: 分析内存性能

进程工具

• list_processes: 列出所有进程
• get_process_info: 获取有关进程的详细信息
• search_processes: 搜索进程
• analyze_top_processes: 按 CPU 和内存使用情况分析顶部进程

存储工具

• list_disks: 列出物理磁盘
• list_partitions: 列出磁盘分区
• get_disk_usage: 获取磁盘使用情况
• analyze_storage_usage: 分析存储使用情况

文件系统工具

• list_directory: 列出目录的内容
• read_file: 读取文件内容
• write_file: 将内容写入文件
• delete_file: 删除文件或目录
• copy_file: 复制文件或目录
• move_file: 移动文件或目录
• search_files: 搜索与模式匹配的文件
• search_file_contents: 搜索包含模式的文件

硬件工具

• get_system_info: 获取常规系统信息
• get_cpu_info: 获取 CPU 信息
• get_memory_info: 获取内存信息
• get_storage_info: 获取存储信息
• get_pci_devices: 获取 PCI 设备信息
• get_usb_devices: 获取 USB 设备信息
• analyze_hardware: 分析硬件配置

网络工具

• get_network_interfaces: 获取网络接口信息
• get_network_connections: 获取网络连接
• get_network_stats: 获取网络统计信息
• ping_host: Ping 主机
• traceroute_host: 跟踪到主机的路由
• http_get_request: 执行 HTTP GET 请求
• download_file_from_url: 从 URL 下载文件
• upload_file_to_url: 将文件上传到 URL
• analyze_network: 分析网络配置和连接性

监控工具

• get_system_status: 获取系统状态
• check_system_health: 检查系统健康状况
• monitor_resources: 监控资源使用情况
• get_system_uptime: 获取系统运行时间
• get_system_load: 获取系统负载
• analyze_system_performance: 分析系统性能

资源

服务器还提供可以通过 MCP 访问的各种资源：

系统资源

• linux://system/info: 系统信息
• linux://system/cpu: CPU 信息
• linux://system/memory: 内存信息
• linux://system/uptime: 系统运行时间

监控资源

• linux://monitoring/status: 系统状态
• linux://monitoring/health: 系统健康状况
• linux://monitoring/resources: 资源使用情况

文件系统资源

• linux://fs/dir/{path}: 目录列表
• linux://fs/info/{path}: 文件信息
• linux://fs/file/{path}: 文件内容
• linux://fs/usage/{path}: 目录使用情况分析

网络资源

• linux://network/interfaces: 网络接口
• linux://network/connections: 网络连接
• linux://network/stats: 网络统计信息
• linux://network/ping/{host}: Ping 主机
• linux://network/traceroute/{host}: 跟踪到主机的路由
• linux://network/analysis: 网络分析

安全注意事项

服务器提供对各种系统操作的访问，如果滥用，可能会非常危险。 确保：

• 配置文件系统操作的允许路径
• 配置网络操作的允许域名
• 限制终止进程的能力
• 使用适当的权限运行服务器

许可证

该项目已获得 MIT 许可证的许可 - 有关详细信息，请参阅 LICENSE 文件。