📌Overview

Purpose: The framework aims to enable the Claude desktop application to execute long-running terminal commands and manage processes effectively.

Overview: Desktop Commander MCP extends the functionalities of the Claude desktop app by integrating a Model Context Protocol server that allows for efficient terminal command execution and advanced file editing features. It enhances developer productivity by providing tools for process management, file operations, and code editing capabilities.

Key Features:

Execute Terminal Commands: Run terminal commands with support for output streaming, timeouts, and background execution, enabling real-time process management.
Filesystem Operations: Comprehensive file management capabilities including reading/writing files, creating directories, and performing surgical text replacements or full rewrites in code files, enhancing code editing tasks.

Desktop Commander MCP

Short version: Terminal commands and diff-based file editing.

Features
Installation
Usage
Handling Long-Running Commands
Work in Progress and TODOs
Contributing
License

This server allows the Claude desktop app to execute long-running terminal commands on your computer and manage processes through Model Context Protocol (MCP), built on top of the MCP Filesystem Server for additional file editing capabilities.

Features

Execute terminal commands with output streaming
Command timeout and background execution support
Process management (list and kill processes)
Session management for long-running commands
Full filesystem operations:
- Read/write files
- Create/list directories
- Move files/directories
- Search files
- Get file metadata
- Surgical text replacements and full file rewrites for code editing

Installation

First, ensure you have downloaded and installed the Claude Desktop app and you have npm installed.

Installing via Smithery

Run the following command:

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

Install through npx

Just run:

npx @wonderwhy-er/desktop-commander setup

Add to Configuration Manually

Edit your claude_desktop_config.json with the following:

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

Clone Locally

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

Usage

Terminal Tools

execute_command: Run commands with configurable timeout
read_output: Get output from long-running commands
force_terminate: Stop running command sessions
list_sessions: View active 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
get_file_info: File metadata

Edit Tools

edit_block: Apply surgical text replacements
write_file: Complete file rewrites

Handling Long-Running Commands

execute_command returns after timeout with initial output.
Command continues in the background.
Use read_output with PID to get new output.
Use force_terminate to stop if needed.

Model Context Protocol Integration

This project extends the MCP Filesystem Server to enable:

Local server support in Claude Desktop
Command execution and process management
File operations and code editing

Work in Progress and TODOs

Current features under development or planned:

Better configurations - Improved settings for allowed paths and commands
Platform-specific fixes - Enhancements for Windows and Linux compatibility
Support for WSL and SSH - Remote command execution capabilities

Website

Visit our official website at desktopcommander.app for the latest information and updates.

Contributing

If you find this project useful, please consider giving it a ⭐ star on GitHub!

We welcome contributions:

Found a bug? Report it on GitHub.
Have a feature idea? Submit a feature request.
Want to contribute code? Fork the repository and submit a pull request.

For any questions or discussions, open a discussion in GitHub.

If you find this tool valuable for your workflow, please consider supporting the project.

License

MIT

ClaudeDesktopCommander