wonderwhy_er_claudedesktopcommander
by wonderwhy-erClaude Desktop Commander MCP Server
The Claude Desktop Commander MCP Server is a powerful tool that enables Claude Desktop to execute terminal commands, manage processes, and perform file system operations directly from your computer. Built on the Model Context Protocol (MCP), it extends Claude's capabilities to include terminal control, file search, and diff-based file editing.
Features
- Terminal Command Execution: Run commands with real-time output streaming.
- Process Management: List and kill processes with ease.
- Session Management: Handle long-running commands efficiently.
- File System Operations:
- Read/write files.
- Create/list directories.
- Move files/directories.
- Search files and retrieve metadata.
- Code Editing:
- Surgical text replacements for small changes.
- Full file rewrites for major updates.
- Pattern-based replacements and recursive code search.
Installation
Prerequisites
Installation Options
Option 1: Install via Smithery
npx -y @smithery/cli install @wonderwhy-er/desktop-commander --client claude
Option 2: Install via npx
npx @wonderwhy-er/desktop-commander setup
Restart Claude after installation.
Option 3: Manual Configuration
Add the following to your claude_desktop_config.json (found at ~/Library/Application Support/Claude/claude_desktop_config.json on Mac):
{
"mcpServers": {
"desktop-commander": {
"command": "npx",
"args": ["-y", "@wonderwhy-er/desktop-commander"]
}
}
}
Restart Claude.
Option 4: Local Installation
- Clone the repository:
bash git clone https://github.com/wonderwhy-er/ClaudeComputerCommander.git cd ClaudeComputerCommander npm run setup - Restart Claude.
Usage
Terminal Tools
execute_command: Run commands with configurable timeout.read_output: Fetch output from long-running commands.force_terminate: Stop running command sessions.list_processes: View system processes.kill_process: Terminate processes by PID.
Filesystem Tools
read_file/write_file: File operations.create_directory/list_directory: Directory management.search_files: Pattern-based file search.code_search: Recursive ripgrep-based text and code search.
Edit Tools
edit_block: Apply surgical text replacements.write_file: Complete file rewrites.
Example of Search/Replace Block:
filepath.ext
<<<<<<< SEARCH
existing code to replace
=======
new code to insert
>>>>>>> REPLACE
Handling Long-Running Commands
- Use
execute_commandto start the command. - Fetch output with
read_output. - Terminate with
force_terminateif needed.
Work in Progress
- Better configurations: Improved settings for allowed paths and shell environment.
- Windows and Linux improvements: Enhanced compatibility.
- WSL and SSH support: Remote server command execution.
Media and Community
- Article: Claude with MCPs replaced Cursor & Windsurf
- Video Tutorial: Claude Desktop Commander Video Tutorial
- Discord: Join our Discord server for support and discussions.
Testimonials
"It's a life saver! I paid Claude + Cursor currently which I always feel it's kind of duplicated. This solves the problem ultimately."
— YouTube Comment"This is the first comment I've ever left on a youtube video, THANK YOU!"
— YouTube Comment
Contributing
We welcome contributions! If you find this project useful, please consider giving it a ⭐ star on GitHub. For bug reports, feature requests, or code contributions, visit the GitHub repository.
License
This project is licensed under the MIT License. See the LICENSE file for details.
Invite Gmail Contacts
