[{"_1":2,"_586":-5,"_587":-5},"loaderData",{"_3":4,"_53":54,"_55":56,"_57":58,"_386":387},"root",{"_5":6,"_49":50,"_51":52},"appGlobal",{"_7":8,"_38":39,"_40":41},"config",{"_9":10,"_11":12,"_13":14,"_15":16,"_17":18,"_19":20,"_21":22,"_23":-5,"_24":25,"_26":27,"_28":29,"_30":31,"_32":33,"_34":31,"_35":31,"_36":37},"APP_URL","https://glama.ai","CLIENT_ASSETS_URL","https://static.glama.ai/client/","ENVIRONMENT","LIVE","FACEBOOK_PIXEL_ID","1988603181578092","GOOGLE_ANALYTICS_MEASUREMENT_ID","G-GDQ5NW5CB5","GOOGLE_OAUTH2_CLIENT_ID","48173796263-7ohlqirg28gh2a7nel61coff3m1ogjtc.apps.googleusercontent.com","INTERCOM_APP_ID","wgcqevfz","INTERCOM_USER_HASH","POSTHOG_API_KEY","phc_aK0RnJxBEBRE0h0LIz21yyc9w6ylBxwUHMPB4712Bjc","REDDIT_PIXEL_ID","a2_fcqsoymvje51","RELEASE_VERSION","glama@aa9d1aa3","SENTRY_DRY_RUN",false,"SENTRY_DSN","https://fc82aa9f808b13927ff29c56bda4d486@o4507975513735168.ingest.us.sentry.io/4507975514849280","SENTRY_SPOTLIGHT","SENTRY_TRACE","STRIPE_PUBLIC_KEY","pk_live_51QpZQ32LV3sZcHqzHlFuNhgSfggSNaQqCzZw9EMJ8tbhpQyZgcwQj1vz168FxQ35EGRcztKu2MankxiSs7zLCF4g00blUverGs","viewportWidth",1280,"visitorSession",{"_42":43,"_45":-5,"_46":47,"_48":-5},"attributes",[44],"BOT","membership","uid","H4QDRbAA9n","userAccount","nonce","cb94b7d4e0bc1a0421b3e0629103badc","toasts",[],"routes/_public/_layout",{},"routes/_public/mcp/servers/~uid/_layout",{},"routes/_public/mcp/servers/~uid/_pages/_layout",{"_59":-5,"_60":61,"_305":306},"githubUser","mcpServer",{"_62":63,"_64":65,"_42":72,"_81":82,"_83":82,"_84":85,"_90":91,"_113":114,"_115":116,"_117":118,"_109":119,"_120":121,"_125":-5,"_126":127,"_128":129,"_136":-5,"_137":138,"_143":-5,"_144":145,"_148":149,"_46":302,"_303":304},"addedAt",["D",1741482212307],"argumentsJsonSchema",{"_66":67,"_68":69,"_70":71},"type","object","required",[],"properties",{},[73,74,75,76,77,78,79,80],"category:os-automation","category:file-systems","category:developer-tools","hosting:local-only","language:typescript","security_grade:a","quality_grade:a","license_grade:a","descriptionMarkdown","Allows Claude desktop app to execute terminal commands and edit files on your computer through MCP, with features including command execution, process management, and diff-based file editing.","descriptionPlainText","githubProject",{"_86":87,"_88":89},"readme","# Claude Desktop Commander MCP\n\n[![npm downloads](https://img.shields.io/npm/dw/@wonderwhy-er/desktop-commander)](https://www.npmjs.com/package/@wonderwhy-er/desktop-commander)\n[![smithery badge](https://smithery.ai/badge/@wonderwhy-er/desktop-commander)](https://smithery.ai/server/@wonderwhy-er/desktop-commander)\n\nShort version. Two key things. Terminal commands and diff based file editing.\n\n\n $\"Claude$ \n\n\nThis is server that allows Claude desktop app to execute long-running terminal commands on your computer and manage processes through Model Context Protocol (MCP) + Built on top of [MCP Filesystem Server](https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem) to provide additional search and replace file editing capabilities .\n\n## Features\n\n- Execute terminal commands with output streaming\n- Command timeout and background execution support\n- Process management (list and kill processes)\n- Session management for long-running commands\n- Full filesystem operations:\n - Read/write files\n - Create/list directories\n - Move files/directories\n - Search files\n - Get file metadata\n - Code editing capabilities:\n - Surgical text replacements for small changes\n - Full file rewrites for major changes\n - Multiple file support\n - Pattern-based replacements\n\n## Installation\nFirst, ensure you've downloaded and installed the [Claude Desktop app](https://claude.ai/download) and you have [npm installed](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm).\n\n### Option 1: Installing via Smithery\n\nTo install Desktop Commander for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@wonderwhy-er/desktop-commander):\n\n```bash\nnpx -y @smithery/cli install @wonderwhy-er/desktop-commander --client claude\n```\n\n### Option 2: Install trough npx\nJust run this in terminal\n```\nnpx @wonderwhy-er/desktop-commander setup\n```\nRestart Claude if running\n\n### Option 3: Add to claude_desktop_config by hand\nAdd this entry to your claude_desktop_config.json (on Mac, found at ~/Library/Application\\ Support/Claude/claude_desktop_config.json):\n```json\n{\n \"mcpServers\": {\n \"desktop-commander\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@wonderwhy-er/desktop-commander\"\n ]\n }\n }\n}\n```\nRestart Claude if running\n\n### Option 4: Checkout locally\n1. Clone and build:\n```bash\ngit clone https://github.com/wonderwhy-er/ClaudeComputerCommander.git\ncd ClaudeComputerCommander\nnpm run setup\n```\nRestart Claude if running\n\nThe setup command will:\n- Install dependencies\n- Build the server\n- Configure Claude's desktop app\n- Add MCP servers to Claude's config if needed\n\n## Usage\n\nThe server provides these tool categories:\n\n### Terminal Tools\n- `execute_command`: Run commands with configurable timeout\n- `read_output`: Get output from long-running commands\n- `force_terminate`: Stop running command sessions\n- `list_sessions`: View active command sessions\n- `list_processes`: View system processes\n- `kill_process`: Terminate processes by PID\n- `block_command`/`unblock_command`: Manage command blacklist\n\n### Filesystem Tools\n- `read_file`/`write_file`: File operations\n- `create_directory`/`list_directory`: Directory management \n- `move_file`: Move/rename files\n- `search_files`: Pattern-based file search\n- `get_file_info`: File metadata\n\n### Edit Tools\n- `edit_block`: Apply surgical text replacements (best for changes <20% of file size)\n- `write_file`: Complete file rewrites (best for large changes >20% or when edit_block fails)\n\nSearch/Replace Block Format:\n```\nfilepath.ext\n<<<<<<< SEARCH\nexisting code to replace\n=======\nnew code to insert\n>>>>>>> REPLACE\n```\n\nExample:\n```\nsrc/main.js\n<<<<<<< SEARCH\nconsole.log(\"old message\");\n=======\nconsole.log(\"new message\");\n>>>>>>> REPLACE\n```\n\n## Handling Long-Running Commands\n\nFor commands that may take a while:\n\n1. `execute_command` returns after timeout with initial output\n2. Command continues in background\n3. Use `read_output` with PID to get new output\n4. Use `force_terminate` to stop if needed\n\n## Model Context Protocol Integration\n\nThis project extends the MCP Filesystem Server to enable:\n- Local server support in Claude Desktop\n- Full system command execution\n- Process management\n- File operations\n- Code editing with search/replace blocks\n\nCreated as part of exploring Claude MCPs: https://youtube.com/live/TlbjFDbl5Us\n\n## Contributing\n\nIf you find this project useful, please consider giving it a ⭐ star on GitHub! This helps others discover the project and encourages further development.\n\nWe welcome contributions from the community! Whether you've found a bug, have a feature request, or want to contribute code, here's how you can help:\n\n- **Found a bug?** Open an issue at [github.com/wonderwhy-er/ClaudeComputerCommander/issues](https://github.com/wonderwhy-er/ClaudeComputerCommander/issues)\n- **Have a feature idea?** Submit a feature request in the issues section\n- **Want to contribute code?** Fork the repository, create a branch, and submit a pull request\n- **Questions or discussions?** Start a discussion in the GitHub Discussions tab\n\nAll contributions, big or small, are greatly appreciated!\n\n## License\n\nMIT","url","https://github.com/wonderwhy-er/ClaudeComputerCommander","githubRepository",{"_92":93,"_94":95,"_96":97,"_98":99,"_100":101,"_105":106,"_107":108,"_111":112},"defaultBranch","main","fullName","wonderwhy-er/ClaudeComputerCommander","githubTreeId",82781,"language","TypeScript","owner",{"_102":103,"_104":31},"login","wonderwhy-er","verified","recentStargazers",17,"spdxLicense",{"_109":110},"name","MIT License","stargazers",66,"id",1703,"inspectable",true,"integrations",[],"Claude Desktop Commander MCP","npmPackage",{"_109":122,"_123":124},"@wonderwhy-er/desktop-commander","weeklyDownloads",605,"prompts","redditPostForeignId","1j6wl6u","relatedMcpServerIds",[130,131,132,133,134,135],1579,544,1384,1396,1624,506,"resources","scores",{"_139":140,"_141":140,"_142":140},"license",100,"quality","security","simpleIcon","supportedPlatforms",[146,147],"MACOS","WINDOWS","tools",[150,167,175,182,187,193,200,207,214,220,228,239,248,255,262,272,281,288,294],{"_109":151,"_152":153,"_154":155},"execute_command","description","Execute a terminal command with timeout. Command will continue running in background if it doesn't complete within timeout.","inputSchema",{"_66":67,"_156":157,"_68":158,"_70":160,"_166":31},"$schema","http://json-schema.org/draft-07/schema#",[159],"command",{"_159":161,"_163":164},{"_66":162},"string","timeout_ms",{"_66":165},"number","additionalProperties",{"_109":168,"_152":169,"_154":170},"read_output","Read new output from a running terminal session.",{"_66":67,"_156":157,"_68":171,"_70":173,"_166":31},[172],"pid",{"_172":174},{"_66":165},{"_109":176,"_152":177,"_154":178},"force_terminate","Force terminate a running terminal session.",{"_66":67,"_156":157,"_68":179,"_70":180,"_166":31},[172],{"_172":181},{"_66":165},{"_109":183,"_152":184,"_154":185},"list_sessions","List all active terminal sessions.",{"_66":67,"_156":157,"_70":186,"_166":31},{},{"_109":188,"_152":189,"_154":190},"list_processes","List all running processes. Returns process information including PID, command name, CPU usage, and memory usage.",{"_66":67,"_68":191,"_70":192},[],{},{"_109":194,"_152":195,"_154":196},"kill_process","Terminate a running process by PID. Use with caution as this will forcefully terminate the specified process.",{"_66":67,"_156":157,"_68":197,"_70":198,"_166":31},[172],{"_172":199},{"_66":165},{"_109":201,"_152":202,"_154":203},"block_command","Add a command to the blacklist. Once blocked, the command cannot be executed until unblocked.",{"_66":67,"_156":157,"_68":204,"_70":205,"_166":31},[159],{"_159":206},{"_66":162},{"_109":208,"_152":209,"_154":210},"unblock_command","Remove a command from the blacklist. Once unblocked, the command can be executed normally.",{"_66":67,"_156":157,"_68":211,"_70":212,"_166":31},[159],{"_159":213},{"_66":162},{"_109":215,"_152":216,"_154":217},"list_blocked_commands","List all currently blocked commands.",{"_66":67,"_68":218,"_70":219},[],{},{"_109":221,"_152":222,"_154":223},"read_file","Read the complete contents of a file from the file system. Handles various text encodings and provides detailed error messages if the file cannot be read. Only works within allowed directories.",{"_66":67,"_156":157,"_68":224,"_70":226,"_166":31},[225],"path",{"_225":227},{"_66":162},{"_109":229,"_152":230,"_154":231},"read_multiple_files","Read the contents of multiple files simultaneously. Each file's content is returned with its path as a reference. Failed reads for individual files won't stop the entire operation. Only works within allowed directories.",{"_66":67,"_156":157,"_68":232,"_70":234,"_166":31},[233],"paths",{"_233":235},{"_66":236,"_237":238},"array","items",{"_66":162},{"_109":240,"_152":241,"_154":242},"write_file","Completely replace file contents. Best for large changes (>20% of file) or when edit_block fails. Use with caution as it will overwrite existing files. Only works within allowed directories.",{"_66":67,"_156":157,"_68":243,"_70":245,"_166":31},[225,244],"content",{"_225":246,"_244":247},{"_66":162},{"_66":162},{"_109":249,"_152":250,"_154":251},"create_directory","Create a new directory or ensure a directory exists. Can create multiple nested directories in one operation. Only works within allowed directories.",{"_66":67,"_156":157,"_68":252,"_70":253,"_166":31},[225],{"_225":254},{"_66":162},{"_109":256,"_152":257,"_154":258},"list_directory","Get a detailed listing of all files and directories in a specified path. Results distinguish between files and directories with [FILE] and [DIR] prefixes. Only works within allowed directories.",{"_66":67,"_156":157,"_68":259,"_70":260,"_166":31},[225],{"_225":261},{"_66":162},{"_109":263,"_152":264,"_154":265},"move_file","Move or rename files and directories. Can move files between directories and rename them in a single operation. Both source and destination must be within allowed directories.",{"_66":67,"_156":157,"_68":266,"_70":269,"_166":31},[267,268],"source","destination",{"_267":270,"_268":271},{"_66":162},{"_66":162},{"_109":273,"_152":274,"_154":275},"search_files","Recursively search for files and directories matching a pattern. Searches through all subdirectories from the starting path. Only searches within allowed directories.",{"_66":67,"_156":157,"_68":276,"_70":278,"_166":31},[225,277],"pattern",{"_225":279,"_277":280},{"_66":162},{"_66":162},{"_109":282,"_152":283,"_154":284},"get_file_info","Retrieve detailed metadata about a file or directory including size, creation time, last modified time, permissions, and type. Only works within allowed directories.",{"_66":67,"_156":157,"_68":285,"_70":286,"_166":31},[225],{"_225":287},{"_66":162},{"_109":289,"_152":290,"_154":291},"list_allowed_directories","Returns the list of directories that this server is allowed to access.",{"_66":67,"_68":292,"_70":293},[],{},{"_109":295,"_152":296,"_154":297},"edit_block","Apply surgical text replacements to files. Best for small changes (<20% of file size). Multiple blocks can be used for separate changes. Will verify changes after application. Format: filepath, then <<<<<<< SEARCH, content to find, =======, new content, >>>>>>> REPLACE.",{"_66":67,"_156":157,"_68":298,"_70":300,"_166":31},[299],"blockContent",{"_299":301},{"_66":162},"zempur9oh4","updatedAt",["D",1742040417506],"meta",[307,310,311,318,321,323,326,329,332,335,338,340,343,346,348,350,352,354,356],{"_308":309},"title","Claude Desktop Commander MCP | Glama",{"_244":82,"_109":152},{"_312":313,"_314":315,"_316":317},"href","https://glama.ai/mcp/servers/zempur9oh4","rel","canonical","tagName","link",{"_244":119,"_319":320},"property","og:title",{"_244":82,"_319":322},"og:description",{"_244":324,"_319":325},"https://glama.ai/logo.png","og:logo",{"_244":327,"_319":328},"https://glama.ai/mcp/servers/zempur9oh4/og-image","og:image",{"_244":330,"_319":331},"630","og:image:height",{"_244":333,"_319":334},"1200","og:image:width",{"_244":336,"_319":337},"website","og:type",{"_244":313,"_319":339},"og:url",{"_244":341,"_319":342},"ChatGPT alternative for power users","og:site_name",{"_244":344,"_109":345},"summary_large_image","twitter:card",{"_244":341,"_109":347},"twitter:title",{"_244":82,"_109":349},"twitter:description",{"_244":327,"_109":351},"twitter:image",{"_244":330,"_109":353},"twitter:image:height",{"_244":333,"_109":355},"twitter:image:width",{"_357":358},"script:ld+json",{"_359":360,"_361":362},"@context","http://schema.org","@graph",[363],{"_359":364,"_365":366,"_367":368},"https://schema.org","@type","BreadcrumbList","itemListElement",[369,376,380,384],{"_365":370,"_371":372,"_109":373,"_374":375},"ListItem","item","https://glama.ai/","Glama","position",1,{"_365":370,"_371":377,"_109":378,"_374":379},"https://glama.ai/mcp","MCP",2,{"_365":370,"_371":381,"_109":382,"_374":383},"https://glama.ai/mcp/servers","Servers",3,{"_365":370,"_371":313,"_109":119,"_374":385},4,"routes/_public/mcp/servers/~uid/_pages/tools/~name/_route",{"_60":388,"_500":-5,"_501":502,"_305":508,"_545":546,"_40":585},{"_62":389,"_64":390,"_42":393,"_81":82,"_83":82,"_84":394,"_90":395,"_113":114,"_115":116,"_117":398,"_109":119,"_120":399,"_125":-5,"_126":127,"_128":400,"_136":-5,"_137":401,"_143":-5,"_144":402,"_148":403,"_46":302,"_303":499},["D",1741482212307],{"_66":67,"_68":391,"_70":392},[],{},[73,74,75,76,77,78,79,80],{"_86":87,"_88":89},{"_92":93,"_94":95,"_96":97,"_98":99,"_100":396,"_105":106,"_107":397,"_111":112},{"_102":103,"_104":31},{"_109":110},[],{"_109":122,"_123":124},[130,131,132,133,134,135],{"_139":140,"_141":140,"_142":140},[146,147],[404,410,415,420,423,427,432,437,442,446,451,457,463,468,473,479,485,490,494],{"_109":151,"_152":153,"_154":405},{"_66":67,"_156":157,"_68":406,"_70":407,"_166":31},[159],{"_159":408,"_163":409},{"_66":162},{"_66":165},{"_109":168,"_152":169,"_154":411},{"_66":67,"_156":157,"_68":412,"_70":413,"_166":31},[172],{"_172":414},{"_66":165},{"_109":176,"_152":177,"_154":416},{"_66":67,"_156":157,"_68":417,"_70":418,"_166":31},[172],{"_172":419},{"_66":165},{"_109":183,"_152":184,"_154":421},{"_66":67,"_156":157,"_70":422,"_166":31},{},{"_109":188,"_152":189,"_154":424},{"_66":67,"_68":425,"_70":426},[],{},{"_109":194,"_152":195,"_154":428},{"_66":67,"_156":157,"_68":429,"_70":430,"_166":31},[172],{"_172":431},{"_66":165},{"_109":201,"_152":202,"_154":433},{"_66":67,"_156":157,"_68":434,"_70":435,"_166":31},[159],{"_159":436},{"_66":162},{"_109":208,"_152":209,"_154":438},{"_66":67,"_156":157,"_68":439,"_70":440,"_166":31},[159],{"_159":441},{"_66":162},{"_109":215,"_152":216,"_154":443},{"_66":67,"_68":444,"_70":445},[],{},{"_109":221,"_152":222,"_154":447},{"_66":67,"_156":157,"_68":448,"_70":449,"_166":31},[225],{"_225":450},{"_66":162},{"_109":229,"_152":230,"_154":452},{"_66":67,"_156":157,"_68":453,"_70":454,"_166":31},[233],{"_233":455},{"_66":236,"_237":456},{"_66":162},{"_109":240,"_152":241,"_154":458},{"_66":67,"_156":157,"_68":459,"_70":460,"_166":31},[225,244],{"_225":461,"_244":462},{"_66":162},{"_66":162},{"_109":249,"_152":250,"_154":464},{"_66":67,"_156":157,"_68":465,"_70":466,"_166":31},[225],{"_225":467},{"_66":162},{"_109":256,"_152":257,"_154":469},{"_66":67,"_156":157,"_68":470,"_70":471,"_166":31},[225],{"_225":472},{"_66":162},{"_109":263,"_152":264,"_154":474},{"_66":67,"_156":157,"_68":475,"_70":476,"_166":31},[267,268],{"_267":477,"_268":478},{"_66":162},{"_66":162},{"_109":273,"_152":274,"_154":480},{"_66":67,"_156":157,"_68":481,"_70":482,"_166":31},[225,277],{"_225":483,"_277":484},{"_66":162},{"_66":162},{"_109":282,"_152":283,"_154":486},{"_66":67,"_156":157,"_68":487,"_70":488,"_166":31},[225],{"_225":489},{"_66":162},{"_109":289,"_152":290,"_154":491},{"_66":67,"_68":492,"_70":493},[],{},{"_109":295,"_152":296,"_154":495},{"_66":67,"_156":157,"_68":496,"_70":497,"_166":31},[299],{"_299":498},{"_66":162},["D",1742040417506],"mcpServerInstance","mcpServerTool",{"_152":209,"_113":503,"_154":504,"_109":208},14212,{"_156":157,"_166":31,"_70":505,"_68":507,"_66":67},{"_159":506},{"_66":162},[159],[509,511,512,513,515,516,517,518,519,520,521,522,523,524,525,526,527,528,529],{"_308":510},"unblock_command - Claude Desktop Commander MCP | Glama",{"_244":209,"_109":152},{"_312":313,"_314":315,"_316":317},{"_244":514,"_319":320},"unblock_command - Claude Desktop Commander MCP",{"_244":209,"_319":322},{"_244":324,"_319":325},{"_244":327,"_319":328},{"_244":330,"_319":331},{"_244":333,"_319":334},{"_244":336,"_319":337},{"_244":313,"_319":339},{"_244":341,"_319":342},{"_244":344,"_109":345},{"_244":341,"_109":347},{"_244":209,"_109":349},{"_244":327,"_109":351},{"_244":330,"_109":353},{"_244":333,"_109":355},{"_357":530},{"_359":360,"_361":531},[532],{"_359":364,"_365":366,"_367":533},[534,535,536,537,538,542],{"_365":370,"_371":372,"_109":373,"_374":375},{"_365":370,"_371":377,"_109":378,"_374":379},{"_365":370,"_371":381,"_109":382,"_374":383},{"_365":370,"_371":313,"_109":119,"_374":385},{"_365":370,"_371":539,"_109":540,"_374":541},"https://glama.ai/mcp/servers/zempur9oh4/tools","Tools",5,{"_365":370,"_371":543,"_109":208,"_374":544},"https://glama.ai/mcp/servers/zempur9oh4/tools/unblock_command",6,"otherTools",[547,549,551,553,555,557,559,561,563,565,567,569,571,573,575,577,579,581,583],{"_60":548,"_109":201},{"_46":302},{"_60":550,"_109":249},{"_46":302},{"_60":552,"_109":295},{"_46":302},{"_60":554,"_109":151},{"_46":302},{"_60":556,"_109":176},{"_46":302},{"_60":558,"_109":282},{"_46":302},{"_60":560,"_109":194},{"_46":302},{"_60":562,"_109":289},{"_46":302},{"_60":564,"_109":215},{"_46":302},{"_60":566,"_109":256},{"_46":302},{"_60":568,"_109":188},{"_46":302},{"_60":570,"_109":183},{"_46":302},{"_60":572,"_109":263},{"_46":302},{"_60":574,"_109":221},{"_46":302},{"_60":576,"_109":229},{"_46":302},{"_60":578,"_109":168},{"_46":302},{"_60":580,"_109":273},{"_46":302},{"_60":582,"_109":208},{"_46":302},{"_60":584,"_109":240},{"_46":302},{"_48":-5},"actionData","errors"]

unblock_command

Input Schema

Input Schema (JSON Schema)

Other Tools