pi-computer-mcp
Provides tools for operating a Linux desktop session via X11 and AT-SPI, including window management, UI element observation and interaction (invoke/set text), screenshots, mouse and keyboard control, dragging, scrolling, and waiting.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
pi-computer-mcp
一个 stdio MCP server,让 pi agent 用 codemode 脚本操作 Linux 桌面(X11 + AT-SPI)和一个开着远程调试端口的 Chromium(CDP)。Node 直接运行 .ts,唯一依赖是 dbus-next。
工具
层 | 工具 |
窗口 |
|
界面元素(AT-SPI) |
|
像素与键鼠 |
|
浏览器页面 |
|
等待 |
|
结果约定(structuredContent、outcome 为 delivered / refused / unknown、错误码)写在 server 的 instructions 和各工具描述里,codemode 里用 describeNamespace 查看。
Related MCP server: mcp-linux-desktop
运行
server 必须以桌面用户的身份、在其会话里运行:AT-SPI 的 D-Bus 总线只接受属主连接,root 也连不上。例如 pi 的 mcp.json:
{
"mcpServers": {
"computer": {
"command": "sudo",
"args": ["-n", "-u", "<desktop-user>", "<session-exec>", "node", "/path/to/pi-computer-mcp/src/server.ts"],
"exposure": "codemode"
}
}
}<session-exec> 指一个能带上桌面会话 DISPLAY 和 D-Bus 地址的启动包装。CDP 地址默认 http://127.0.0.1:9222,可用 PI_COMPUTER_CDP_URL 改。
系统依赖:xdotool、scrot、xprop、xwininfo、wmctrl。
局限
没有界面树的程序(Electron、早于 AT-SPI 启动的程序)只能截图加坐标。
输入锁只在一个 server 进程内有效,不要让多个进程或人同时操作桌面。
type只收 ASCII,其他文字用set_text或page_act fill。
开发
npm install,npm run check(类型检查 + 单元测试)。桌面和浏览器部分只能在真实桌面上手动验证。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
A cloud Linux desktop for your AI: browse, click, type, read the screen and run commands.
Operate Linux, macOS and Windows from your LLM. Every action runs through an auditable allowlist.
Use your Mac, Windows or Linux computer from ChatGPT, Claude or Codex: files, commands, documents.
Control a real browser from AI agents: navigate, click, type, screenshot, read the page.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to control Linux/X11 desktops by providing tools for taking screenshots, clicking, typing, and managing windows via AT-SPI and xdotool.3MIT
- AlicenseNot gradedqualityDmaintenanceEnables full Linux desktop control including windows, mouse, keyboard, clipboard, audio, screenshots, OCR, accessibility, and system management through MCP-compatible AI agents.1MIT
- AlicenseAqualityCmaintenanceEnables AI agents to interact with the Linux desktop through desktop notifications, interactive dialogs, shell command execution, and privileged command execution.15MIT
- AlicenseAqualityBmaintenanceEnables local X11 desktop control for MCP clients, including persistent Python execution, AT-SPI accessibility inspection, screenshots, and recoverable mouse/keyboard input for operating real applications.5MIT