Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

wonderwhy-er/DesktopCommanderMCP

AI Engineering

An MCP server that gives AI clients terminal control, filesystem search, and diff-based file editing on the local machine.

10,366
1,298
JavaScript
MIT
1 year old

Desktop Commander MCP

Desktop Commander is a Model Context Protocol (MCP) server that extends AI clients — Claude Desktop, Claude Code, Cursor, Windsurf, VS Code/Copilot, Codex, JetBrains, Gemini CLI and others — with terminal control, full filesystem operations, and search/replace code editing. It is built on top of the MCP Filesystem Server and adds process management, in-memory code execution, and native handling of Excel, PDF, and DOCX files README.

It targets developers who want an AI assistant to work across the whole operating system rather than inside a single IDE: running long-lived shells, SSH sessions, or database clients, exploring large codebases, editing files surgically, and analyzing data files by asking in chat. The server runs locally under your user permissions and, when installed via npx or Smithery, uses the host client's subscription rather than separate API credits.

Quick start (Claude Desktop)

Prerequisite: Node.js installed. Run the setup command, then restart Claude Desktop:

npx @wonderwhy-er/desktop-commander@latest setup

This registers the server in Claude's claude_desktop_config.json and auto-updates when Claude restarts. To remove it, run npx @wonderwhy-er/desktop-commander@latest remove. Alternatives include a macOS bash installer, Smithery, manual JSON config, a local checkout, and Docker; on Windows, use the npx route or the manual JSON entry in %APPDATA%\Claude\claude_desktop_config.json README. Other clients use the same standard JSON block — for example claude mcp add --scope user desktop-commander -- npx -y @wonderwhy-er/desktop-commander@latest for Claude Code README.

Once connected, ask things like "Analyze sales.csv and show top customers" (Claude runs Python in memory) or "Start Node.js and test this API"; the server provides tools such as start_process, interact_with_process, read_process_output, read_file, write_file, and edit_block with a SEARCH/REPLACE block format README. Remote clients (ChatGPT, Claude web) can reach commands executed on your machine by starting npx @wonderwhy-er/desktop-commander@latest remote and connecting at the Remote MCP entry, with a separate setup guide for the remote device README.

Constraints and security

  • Not a sandbox. The directory allow-list restricts file operations only; terminal commands can still reach paths outside it, and blocking can be bypassed through symlinks, command substitution, or absolute paths. For production isolation, use the Docker installation SECURITY.md.
  • Local logs may contain sensitive data. Every tool call's arguments are written unredacted to a local claude_tool_call.log (rotated at 10 MB), and recent history is stored in tool-history.jsonl (bounded to roughly the newest 4 MiB). These are local files, not server-side audit records.
  • Optional telemetry. Pseudonymous telemetry is enabled by default and does not include file contents, paths, or command arguments; disable it via config or by asking Claude PRIVACY.md.
  • Configuration changes in a chat where Claude is not doing filesystem work, since the model may try to loosen settings like allowedDirectories when it hits access errors.
  • Platform requirements. Most install routes need Node.js; Docker requires Docker Desktop. License is MIT.

HotRepo's take

Between 2026-07-08 and 2026-07-13, the repository's daily all-language snapshots show stars climbing from 6,312 to 8,123, with a single-day peak of 900 new stars on 2026-07-11 — a sharp burst that places the project among the more rapidly starred MCP utilities in that week's data. By 2026-11-19 it sat at 10,362 stars and ranked third on the JavaScript daily list, indicating the growth was not a one-off spike. The README's breadth of client support and its explicit security caveats suggest a mature MCP integration rather than a thin wrapper; readers evaluating it should weigh the convenience of full-system terminal access against the absence of a default sandbox.

Written by AI from the project's README, updated . The project's own docs are the source of truth.

Hacker News

Desktop Commander MCP
▲ 2 · 0 comments · June 23, 2026
Recomment a MCP for Claude Desktop
▲ 1 · 0 comments · May 2, 2025

You might also like

  1. oraios/serenaAn MCP server that gives coding agents IDE-like symbol search, refactoring and editing tools across more than 40 languages.Python30,969
  2. shanselman/sandbox-mcpAutomate fresh Windows Sandbox machines for app testing, UI automation, installer diffs and safe file detonation via CLI or MCP.JavaScript108
  3. Graphicle-AI/graphicleA local code graph plus project memory that serves cited excerpts to coding agents over MCP.Rust356