DesktopCommander

Created 5 months ago

Search, update, manage files and run terminal commands with AI.

development location documentation public AI automation

What is DesktopCommander?

Let AI edit and manage files on your computer, run terminal commands, and connect to remote servers via SSH - all powered by one of the most popular local MCP servers.

Documentation

Desktop Commander MCP

Features

Enhanced terminal commands with interactive process control
Execute code in memory (Python, Node.js, R) without saving files
Instant data analysis - just ask to analyze CSV/JSON files
Interact with running processes (SSH, databases, development servers)
Execute terminal commands with output streaming
Command timeout and background execution support
Process management (list and kill processes)
Session management for long-running commands
Server configuration management
Full filesystem operations
Code editing capabilities
Comprehensive audit logging

Installation# Option 1: Install through npx

Just run this in terminal:

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

Option 2: Using bash script installer (macOS)

For macOS users, you can use our automated bash installer:

curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install.sh | bash

Option 3: Installing via Smithery

To install Desktop Commander for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @wonderwhy-er/desktop-commander --client claude

Option 4: Add to claude_desktop_config manually

Add this entry to your claude_desktop_config.json:

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

Option 5: Checkout locally

Clone and build:

git clone https://github.com/wonderwhy-er/DesktopCommanderMCP.git
cd DesktopCommanderMCP
npm run setup

Usage

The server provides a comprehensive set of tools organized into several categories:

Available Tools

Category	Tool	Description
Configuration	`get_config`	Get the complete server configuration as JSON
Terminal	`start_process`	Start programs with smart detection of when they're ready for input
Filesystem	`read_file`	Read contents from local filesystem or URLs
Text Editing	`edit_block`	Apply targeted text replacements
Analytics	`get_usage_stats`	Get usage statistics for your own insight

License

This project is open source and available under the MIT License.

Server Config

{
  "mcpServers": {
    "desktopcommander-server": {
      "command": "npx",
      "args": [
        "desktopcommander"
      ]
    }
  }
}

Links & Status

Repository: github.com

Hosted: No

Global: No

Official: Yes

Project Info

Hosted Featured

Created At: Jul 02, 2025

Updated At: Aug 07, 2025

Author: WonderWhy-er

Category: community

License: MIT License

Tags:

development location documentation