mcp-registry/wonderwhy-er/DesktopCommanderMCP

    ==================
      
       /// MCP ///
      /// WON ///
        
    ==================
        
    [server:online]
    [protocol:ready]

wonderwhy-er/DesktopCommanderMCP

by wonderwhy-er

Model-Context-Protocol (MCP) server that lets Claude Desktop run terminal commands, manage processes and edit/search local files via AI-driven tools.

4.1k
447
Open Source
GitHubWebsiteDocumentation

Installation

1. Prerequisites
• Node.js ≥ 18 and npm ≥ 9
• macOS, Linux or WSL / PowerShell on Windows (server needs shell access)
2. Clone the repository
git clone https://github.com/wonderwhy-er/DesktopCommanderMCP.git cd DesktopCommanderMCP
3. Install dependencies
npm install # or pnpm install
4. (Optional) Build TypeScript sources
npm run build
5. Configure environment
Create a .env file (or export variables) with at least:
CLAUDE_API_KEY= # key for Claude or Anthropic-compatible backend MCP_ALLOWED_CMDS=git,ls,cat,grep # comma-separated white-list of shell commands MCA_ROOT=/absolute/path/to/your/working/directory # sandbox root
You can further lock-down the server via:
MCP_PORT=4077 # default 4077 MCP_HOST=0.0.0.0 # bind address MCP_ENABLE_DIFF=1 # enable AI-assisted diff editing
6. Start the MCP server
npm start # production # or npm run dev # with nodemon/hot-reload
7. Connect your Claude agent to the server
Point the agent to ws://<host>:4077 (or PORT you set). The Claude system prompt should include DesktopCommanderMCP tool descriptions so it can invoke the routes below.

Documentation

License: MIT License
Updated 7/30/2025

Table of Contents