DesktopCommanderMCP  by wonderwhy-er

MCP server for Claude gives it terminal control, file system search, and file editing

created 8 months ago
4,060 stars

Top 12.3% on sourcepulse

GitHubView on GitHub
Project Summary

Desktop Commander MCP provides Claude Desktop with direct access to your terminal, file system, and code editing capabilities, enabling AI-driven automation and task management without API costs. It's designed for developers and power users looking to integrate their AI assistant deeply into their workflow for tasks ranging from code refactoring to system administration.

How It Works

This project extends the Model Context Protocol (MCP) Filesystem Server, allowing Claude to execute terminal commands, manage processes, and perform file operations like searching, reading, writing, and editing. It leverages Node.js for its server-side operations and integrates with Claude Desktop via its MCP interface. The architecture supports streaming command output and managing long-running processes, offering a more robust interaction than typical AI chat interfaces.

Quick Start & Requirements

  • Install: npx @wonderwhy-er/desktop-commander@latest setup (or use the macOS bash installer, Smithery, or manual config).
  • Prerequisites: Claude Desktop app, npm.
  • Setup Time: Minimal, typically under 5 minutes.
  • Docs: https://desktopcommander.app/

Highlighted Details

  • Execute terminal commands with output streaming and process management.
  • Perform full filesystem operations, including recursive code search via ripgrep.
  • Conduct "surgical" text replacements and full file rewrites.
  • Supports fetching content from URLs for read_file.

Maintenance & Community

Licensing & Compatibility

  • License: MIT.
  • Compatibility: Permissive, suitable for commercial use and integration with closed-source projects.

Limitations & Caveats

Terminal commands can access files outside of the allowedDirectories configuration, and full terminal sandboxing is still a roadmap item. Telemetry is enabled by default but can be disabled via chat command.

Health Check
Last commit

1 week ago

Responsiveness

1 day

Pull Requests (30d)
12
Issues (30d)
14
Star History
1,717 stars in the last 90 days

Explore Similar Projects

Feedback? Help us improve.