Mcpvil

🚀 MCPvil

MCPvil 是 Smithay 項目中 smallvil 的一個分支，並集成了 MCP (Model Context Protocol) 服務器。它是一個最小化的 Wayland 合成器，通過 MCP 公開其功能，允許 AI 代理和其他 MCP 客戶端通過標準輸入輸出與合成器進行交互。

✨ 主要特性

MCPvil 藉助 MCP 協議，以最小化的方式實現了 Wayland 合成器的功能，為 AI 代理和 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"
    }
  }
}

📚 詳細文檔

MCP 工具

🔧 技術細節

依賴項

• Smithay — Wayland 合成器庫
• rmcp — Rust MCP 服務器庫
• image — 屏幕截圖編碼庫