Mcpvil

🚀 MCPvil

Smithay プロジェクトの smallvil をフォークし、MCP (Model Context Protocol) サーバーを組み込んだものです。

MCPvil は最小限の Wayland コンポジターで、MCP を介してその機能を公開し、AI エージェントや他の MCP クライアントが標準入出力を通じてコンポジターと対話できるようにします。

✨ 主な機能

🛠️ MCPツール

📦 インストール

システム依存関係 (Debian/Ubuntu)

sudo apt-get install build-essential pkg-config cmake \
  libwayland-dev wayland-protocols libinput-dev libudev-dev \
  libseat-dev libxkbcommon-dev libegl-dev libgles2-mesa-dev \
  libgbm-dev libdrm-dev libxcb1-dev libx11-xcb-dev \
  libdbus-1-dev libsystemd-dev libpixman-1-dev

Cargo を使用したインストール

cargo install --git https://github.com/derekjchow/mcpvil

ソースからビルド

git clone https://github.com/derekjchow/mcpvil.git
cd mcpvil
cargo build

💻 使用例

基本的な使用法

MCPvil は MCP プロトコル（改行区切りの JSON-RPC）を使用して標準入出力で通信します。任意の MCP 互換クライアントと一緒に使用できます。

# 直接実行（標準入出力で MCP サーバー、標準エラー出力でコンポジターのログ）
mcpvil

# デバッグログ付きで実行
RUST_LOG=debug mcpvil

# GUI モード（視覚的な検査用のウィンドウを開く）
mcpvil --gui

高度な使用法

MCP クライアントとのセットアップ

Claude Code

claude mcp add mcpvil -- mcpvil

Gemini CLI

~/.gemini/settings.json に以下を追加します。

{
  "mcpServers": {
    "mcpvil": {
      "command": "mcpvil"
    }
  }
}

🔧 技術詳細

依存関係

• Smithay — Wayland コンポジターライブラリ
• rmcp — Rust MCP サーバーライブラリ
• image — スクリーンショットエンコード