MCP Linux Common Utility Server

The Model Context Protocol (MCP) Linux Common Utility (LCU) Server is a Python-based server that provides access to various Linux system operations and information through the Model Context Protocol.

Features

• CPU Operations: CPU information, usage, load average, etc.
• Memory Operations: Memory and swap information, usage statistics.
• Process/Thread Operations: Process listing, information, and management.
• Storage Operations: Disk, volume, and partition information.
• Filesystem Operations: File creation, deletion, updating, and information.
• Hardware Operations: Hardware detection and information.
• Network Operations: Interface information, connectivity testing, and data transfer.
• Monitoring Operations: System status monitoring and health checks.
• Log Operations: Access to system logs, log analysis, and statistics across multiple sources.

Installation

Prerequisites

• Python 3.10 or higher
• Linux operating system

Installation Steps

1. Clone the repository:

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

2. Install the package:

   uv venv
   source .venv/bin/activate
   python -m build
   

Configuration

The server can be configured using a YAML configuration file. By default, it looks for the configuration file in the following locations:

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

You can also specify a custom configuration file path using the --config command-line option.

Configuration File Example

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

monitoring:
  enabled: true
  interval: 30  # seconds
  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:
    - "*"  # Allow all domains

process:
  allow_kill: false
  allowed_users: []

logs:
  # Custom log paths (optional)
  paths: 
    # syslog: /var/log/syslog
    # auth: /var/log/auth.log
  max_entries: 1000  # Maximum entries to return

Usage

Starting the Server

You can start the server using the command-line interface:

mcp-lcu-server [OPTIONS]

Available options:

• --config, -c: Path to the configuration file
• --transport, -t: Transport type (stdio, sse, or both)
• --port, -p: Port for SSE transport
• --host, -h: Host for SSE transport
• --debug, -d: Enable debug logging

Transport Types

The server supports the following transport types:

• stdio: Standard input/output transport
• sse: Server-Sent Events transport

Examples

Start the server with stdio transport:

mcp-lcu-server --transport stdio

Start the server with SSE transport on port 8000:

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

Start the server with both transports:

mcp-lcu-server --transport both

API Documentation

Tools

The server provides various tools for interacting with the Linux system:

CPU Tools

• get_cpu_info: Get detailed CPU information
• get_cpu_usage: Get CPU usage percentage
• get_load_average: Get system load average
• analyze_cpu_performance: Analyze CPU performance

Memory Tools

• get_memory_info: Get detailed memory information
• get_memory_usage: Get memory usage

... View full README on GitHub