M
Mcpvil
by @derekjchow
MCP server by derekjchow
Created 2/12/2026
Updated about 9 hours ago
README
Repository documentation and setup instructions
MCPvil
A fork of smallvil from the Smithay project with an MCP (Model Context Protocol) server bolted onto it.
MCPvil is a minimal Wayland compositor that exposes its functionality through MCP, allowing AI agents and other MCP clients to interact with the compositor over stdio.
MCP Tools
| Tool | Description |
|------|-------------|
| launch_app | Launches an application inside the compositor |
| screenshot | Captures a screenshot of the active window and saves it as a PNG |
Building
cargo build
Usage
MCPvil communicates over stdio using the MCP protocol (newline-delimited JSON-RPC). It can be used with any MCP-compatible client.
# Run directly (MCP server on stdio, compositor logs on stderr)
./target/debug/mcpvil
# With debug logging
RUST_LOG=debug ./target/debug/mcpvil
Dependencies
Quick Setup
Installation guide for this server
Installation Command (package not published)
git clone https://github.com/derekjchow/mcpvil
Manual Installation: Please check the README for detailed setup instructions and any additional dependencies required.
Cursor configuration (mcp.json)
{
"mcpServers": {
"derekjchow-mcpvil": {
"command": "git",
"args": [
"clone",
"https://github.com/derekjchow/mcpvil"
]
}
}
}