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
     

💻 使用例

基本的な使用法

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"))  # システム情報の取得
     

高度な使用法

システムツール

• コマンドの実行
  • シェルコマンドを実行します：

    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 システムと通信します。Python で開発されており、サーバー側では server.py が起動し、クライアント側では MCPClient クラスを使用してサーバーにアクセスします。設定ファイル config.yml を通じて、アクセス可能なパス、許可されたコマンド、ネットワークドメインなどを制御できます。

📄 ライセンス

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 '{"gateway":"192.168.1.1"}'