Desktop Commander MCP
Comprehensive system control and development automation server enabling terminal commands, file operations, and cross-platform workflow management through MCP integration.
Author: wonderwhy-er | GitHub Repo | 3692 Stars|413 Forks|MIT License|Updated Jun 29, 2025
Overview
Desktop Commander MCP provides comprehensive system-level control and development automation through the Model Context Protocol. It enables AI models to execute terminal commands, perform file operations, analyze data, and manage development workflows across Windows, macOS, and Linux platforms. This server transforms AI assistants into powerful system automation tools while maintaining security boundaries.
Features
- Terminal Command Execution - Run shell commands, scripts, and system utilities directly from AI conversations
- Cross-Platform File Operations - File reading, writing, searching, and manipulation across operating systems
- Multi-Language Code Execution - Support for Python, JavaScript, shell scripts, and other languages
- Data Analysis Capabilities - CSV processing, statistical analysis, and data transformation tools
- Development Workflow Automation - Git operations, build processes, and deployment scripts
- Security Controls - Configurable permission system and command validation
Installation
Prerequisites
- Node.js 18.0.0+ for MCP server functionality
- npm package manager
- Compatible MCP client (Claude Desktop, VS Code, Cursor)
Recommended Installation (Auto-Updates)
# Quick setup with npx (recommended)
npx @wonderwhy-er/desktop-commander@latest setup
# Debug mode (if needed)
npx @wonderwhy-er/desktop-commander@latest setup --debug
Manual Configuration
{
"mcpServers": {
"desktop-commander": {
"command": "npx",
"args": [
"-y",
"@wonderwhy-er/desktop-commander"
]
}
}
}
Alternative Installation Methods
# macOS bash script installation
curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install.sh | bash
# Smithery CLI installation
npx -y @smithery/cli install @wonderwhy-er/desktop-commander --client claude
# Local development setup
git clone https://github.com/wonderwhy-er/DesktopCommanderMCP.git
cd DesktopCommanderMCP
npm run setup
Configuration Locations
- macOS:
~/Library/Application\ Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
- Linux:
~/.config/Claude/claude_desktop_config.json
Note: Restart Claude Desktop after installation. Configuration persists between server restarts.
Usage
System Administration
# Example AI interactions:
# "Check system disk usage and clean up temporary files"
# "Monitor running processes and identify high CPU usage"
# "Create a backup script for the project directory"
# "Update system packages and restart services"
The server enables natural language system administration and development automation. You can manage files, execute complex workflows, analyze system performance, and automate repetitive tasks through conversational AI interfaces.
Development Workflows
- Code Analysis: Analyze codebases, generate reports, and identify patterns
- Build Automation: Execute build scripts, run tests, and deploy applications
- Git Operations: Commit changes, manage branches, and handle merge conflicts
- Data Processing: Parse logs, process CSV files, and generate insights
Desktop Commander MCP is developed by wonderwhy-er and is open-source. For technical support, feature requests, and community contributions, please refer to the official GitHub repository.