@wonderwhy-er/desktop-commander

Name: @wonderwhy-er/desktop-commander
Author: samihalawa

general MCP Server

Remote control your Mac with AI — Desktop Commander MCP menubar app for macOS. Connect Claude, GPT-4 and other AI agents to your Mac remotely via MCP protocol.

bysamihalawa

VerifiedInstall Ready

generalgeneral

7 views0 stars1 forksv0.2.37MIT

View on GitHub Homepage

Why This Matters

Discovered via github-topic:model-context-protocol and last synced 1mo ago.

VerifiedInstall Ready

Source: github-topic:model-context-protocol
Stars: 0
Last synced: 1mo ago
Install: Instructions detected

Install

1. Install the package

npx -y @wonderwhy-er/desktop-commander

2. Add to claude_desktop_config.json

{
  "mcpServers": {
    "wonderwhy-er-desktop-commander": {
      "command": "npx",
      "args": [
        "-y",
        "@wonderwhy-er/desktop-commander"
      ]
    }
  }
}

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%\Claude\claude_desktop_config.json (Windows)

Tools

Resources

Prompts

Standard I/O

Transport

Available Tools (26)

start_process

Start programs with smart detection of when they're ready for input

write_pdf

Create new PDF files from markdown or modify existing PDFs (insert/delete pages). Supports HTML/CSS styling and SVG graphics

get_usage_stats

Get usage statistics for your own insight

read_process_output

Read output from running processes

list_directory

Get detailed recursive listing of files and directories (supports depth parameter, default depth=2)

give_feedback_to_desktop_commander

Open feedback form in browser to provide feedback to Desktop Commander Team

force_terminate

Force terminate a running terminal session

list_sessions

List all active terminal sessions

move_file

Move or rename files and directories

start_search

Start streaming search for files by name or content patterns (searches text files and Excel content)

read_file

Read contents from local filesystem, URLs, Excel files (.xlsx, .xls, .xlsm), and PDFs with line/page-based pagination

list_searches

List all active search sessions

list_processes

List all running processes with detailed information

get_more_search_results

Get paginated results from active search with offset support

get_config

Get the complete server configuration as JSON (includes blockedCommands, defaultShell, allowedDirectories, fileReadLineLimit, fileWriteLineLimit, telemetryEnabled)

read_multiple_files

Read multiple files simultaneously

get_file_info

Retrieve detailed metadata about a file or directory (includes sheet info for Excel files)

set_config_value

Set a specific configuration value by key. Available settings: • `blockedCommands`: Array of shell commands that cannot be executed • `defaultShell`: Shell to use for commands (e.g., bash, zsh, powershell) • `allowedDirectories`: Array of filesystem paths the server can access for file operations (⚠️ terminal commands can still access files outside these directories) • `fileReadLineLimit`: Maximum lines to read at once (default: 1000) • `fileWriteLineLimit`: Maximum lines to write at once (default: 50) • `telemetryEnabled`: Enable/disable telemetry (boolean)

write_file

Write file contents with options for rewrite or append mode. Supports Excel files (JSON 2D array format). For PDFs, use `write_pdf`

edit_block

Apply targeted text replacements for text files, or range-based cell updates for Excel files

interact_with_process

Send commands to running programs and get responses

create_directory

Create a new directory or ensure it exists

get_recent_tool_calls

Get recent tool call history with arguments and outputs for debugging and context recovery

kill_process

Terminate a running process by PID

stop_search

Stop an active search gracefully

Browse all MCP servers