MCP Lcu Server

🚀 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 文件。

⚠️ 重要提示

在使用該插件時，請務必根據實際情況合理配置安全參數，避免因配置不當導致系統安全風險。

💡 使用建議

建議在測試環境中先進行充分測試，熟悉插件的各項功能和配置方法後，再應用到生產環境中。