ClaudeDesktopCommander serves as a versatile MCP server designed for the Claude desktop application, enabling users to execute terminal commands, manage system processes, and perform advanced file editing operations seamlessly. Leveraging the Model Context Protocol (MCP), this tool enhances productivity by bridging the gap between command-line functionalities and user-friendly interfaces.

Key Features

• Terminal Command Execution: Run terminal commands with output streaming, configurable timeouts, and support for background processes.
• Process Management: List and terminate active processes efficiently.
• Session Management: Handle long-running command sessions with ease.
• Filesystem Operations: Complete file manipulation capabilities, including:
  • File Editing: Surgical text replacements and comprehensive file rewrites allowed.
  • Directory Management: Create, list, and navigate through directories.
  • File Search: Perform pattern-based searches and retrieve file metadata.
  • Code Editing: Utilize advanced editing functionalities such as multi-file support and vscode-ripgrep based searching within folders.

Example of Code Editing

When making changes to files, use the following format to indicate search and replace operations:

filepath.ext
<<<<<<< SEARCH
existing code to replace
=======
new code to insert
>>>>>>> REPLACE

For instance:

src/main.js
<<<<<<< SEARCH
console.log("old message");
=======
console.log("new message");
>>>>>>> REPLACE

Long-Running Command Handling

For terminal commands that require extended execution time:

1. Use execute_command to initiate the command.
2. The command will continue running in the background after timing out.
3. Retrieve updated output using the read_output function associated with the process ID (PID).
4. Terminate the session if needed using the force_terminate command.

Integration with MCP

The project builds on the MCP Filesystem Server to allow for:

• Local server support within the Claude Desktop environment.
• Comprehensive command execution for all system operations.
• Integrated file management and advanced search capabilities to enhance coding productivity.

For further engagement, additional resources such as a video tutorial and an insightful article are available. Community interaction is encouraged through our Discord server. Any contributions or feedback to improve this tool are greatly appreciated.