Skip to main content
Glama
d11r

servo-mcp

by d11r
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

servo-mcp

A desktop MCP server that gives AI agents the ability to see and control your desktop.

servo-mcp.com - Installation instructions and documentation

What is Servo?

Servo is an MCP (Model Context Protocol) server that enables Claude Code and other AI agents to:

  • Take screenshots of your screen

  • Click buttons and interact with UI elements

  • Type text and press keyboard shortcuts

  • Scroll and navigate applications

  • Verify that changes actually work

Key features:

  • 100% local - no cloud, no telemetry, no data sharing

  • Works on macOS and Windows

  • Pure Node.js with native platform APIs (no Electron, no external dependencies)

  • Simple npm install

Related MCP server: mcp-vision

Installation

Install via npm (macOS and Windows):

npm install -g servo-mcp
npx servo-mcp --setup

macOS Permissions

Grant permissions to your terminal app (Terminal, iTerm, VS Code, Cursor, etc.) in System Settings > Privacy & Security:

  • Accessibility - for mouse clicks and keyboard input

  • Screen Recording - for taking screenshots

Child processes like servo-mcp inherit permissions from the parent terminal app.

Windows

No special permissions required. Windows may prompt for access when servo-mcp runs.

Setup with Claude Code

After running npx servo-mcp --setup, your ~/.claude.json will be configured:

{
  "mcpServers": {
    "servo": {
      "command": "npx",
      "args": ["servo-mcp"]
    }
  }
}

Restart Claude Code and test with: "take a screenshot"

Available Tools

Tool

Description

screenshot

Capture screen

click

Click at x,y coordinates

type_text

Type text at cursor

key_press

Press key combo (e.g., Cmd+S)

scroll

Scroll up/down/left/right

move_mouse

Move cursor to x,y

get_mouse_position

Get cursor position

focus_app

Bring app to foreground

open_app

Launch application

list_windows

List open windows

wait

Wait milliseconds

request_permissions

Open System Preferences

Development

pnpm install
pnpm dev:mcp          # Run MCP server in dev mode
pnpm dev:web          # Run website

# Build
pnpm build:mcp        # Bundle with esbuild

Architecture

Servo is a pure Node.js MCP server that uses:

  • Native platform APIs for automation (no Electron)

  • macOS: screencapture, AppleScript, Python/Quartz

  • Windows: PowerShell, .NET, user32.dll

Links

License

MIT License

Author

Created by Dragos Strugar

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • ComputerMate

    one710
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI to control a computer through mouse, keyboard, and screen capture tools, with support for local native and Docker sandboxed environments.
    7 npm
    5
    MIT

  • mcp-vision

    hussainn7
    A
    license
    Not graded
    quality
    B
    maintenance
    A local autonomous AI agent that watches your screen, understands the visual layout, and executes native OS commands (clicking, typing) without cloud APIs.
    2
    MIT

  • mcp-macos-cua

    bradthebeeble
    A
    license
    A
    quality
    D
    maintenance
    Enables AI agents to control macOS desktop apps via screenshots, mouse clicks, keyboard input, accessibility queries, and AppleScript.
    11
    20 npm
    MIT

  • open-computer-use

    opensymph
    A
    license
    Not graded
    quality
    A
    maintenance
    Lets AI agents see and control desktop applications through the accessibility layer, enabling clicking, typing, scrolling, dragging, and window/app management across macOS, Windows, and Linux entirely on the local machine.
    10
    MIT