Deskcommand MCP Server

deskcommand

Work on the local machine from the command line or as a stdio MCP server: start and drive terminal processes, read and write files, make surgical text edits, move files, inspect metadata, and search file contents — with configuration, usage and recent-call tools alongside.

Filesystem and search are real local implementations. Search runs as a session: start_search walks the tree (skipping node_modules, .git and dist) and returns a session id whose results paginate with get_more_search_results. edit_block replaces an exact text block and refuses ambiguous edits — a block that occurs more than once needs an explicit expected count. Terminal processes run behind an injectable executor; the default spawns real shell processes and buffers their output, so read_process_output returns only output you have not seen yet.

Two honest simplifications against the toolset this is modelled on: write_pdf writes the given content as-is (no PDF layout engine), and search executes synchronously in-process rather than streaming from a ripgrep subprocess.

Install

npx -y @reneturcios/deskcommand mcp

CLI

deskcommand mcp
deskcommand ls <path>
deskcommand read <path>
deskcommand run <command...>
deskcommand search <path> <pattern>
deskcommand --version

Exit codes: 0 success, 1 operation error, 2 usage error.

MCP tools

26 tools: create_directory, edit_block, force_terminate, get_config, get_file_info, get_more_search_results, get_prompts, get_recent_tool_calls, get_usage_stats, give_feedback_to_desktop_commander, interact_with_process, kill_process, list_directory, list_processes, list_searches, list_sessions, move_file, read_file, read_multiple_files, read_process_output, set_config_value, start_process, start_search, stop_search, write_file, write_pdf.

MCP client config:

{
  "mcpServers": {
    "deskcommand": {
      "command": "npx",
      "args": ["-y", "@reneturcios/deskcommand", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/deskcommand          # MCP server
docker run --rm ghcr.io/cloudcorprecords/deskcommand --version

Development

npm install
npm run build
npm test

MIT license.