Deskcommand

io.github.CloudCorpRecords由 GitHub 帳號 CloudCorpRecords 發布v0.1.0更新於 Nov 7, 2026

Run terminal processes, edit files and search code on the local machine from an MCP client.

已驗證STDIO僅桌面檔案與儲存開發者工具

概覽

AI 產生的概覽

讓助理透過 stdio MCP 伺服器在本機執行終端機程序、讀寫檔案、做精確文字編輯並搜尋程式碼。

可以做什麼
  • 讀寫與檢視檔案：讀取單一或多個檔案、寫入或覆寫檔案、建立目錄、移動或重新命名、取得中繼資料、列出目錄
  • 以精確文字區塊取代進行局部編輯，遇到多處符合時會拒絕執行
  • 在指定路徑下依樣式搜尋檔案內容，以工作階段方式分頁取得、列出與停止搜尋
  • 執行終端機程序：在 shell 中啟動、送出輸入、讀取新輸出、列出工作階段與程序、依 PID 結束或強制終止
  • 檢視伺服器自身狀態：讀取與設定組態、使用統計、最近工具呼叫、提示詞，以及送出意見回饋
適用情境
適合需要助理直接操作本機程式碼庫或電腦的情境：讀取與修改專案檔案、搜尋原始碼，以及在聊天用戶端中執行或驅動 shell 指令與長時間執行的程序。
執行需求
以 stdio 方式在本機執行，可透過 npx 使用 npm 套件，或使用已發佈的 Docker 映像。未宣告任何驗證、環境變數或標頭。僅限桌面環境，沒有網頁託管版本。
安裝前請注意
它賦予助理相當大的本機權限：寫入與覆寫檔案、移動檔案、啟動或結束 shell 程序，建議只在可信任的工作區內使用。write_pdf 只是依原樣寫入內容，並不會產生真正的 PDF 版面；搜尋是在程序內同步執行，而非透過 ripgrep 子程序。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Deskcommand，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

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

bash
npx -y @reneturcios/deskcommand mcp

CLI

bash
deskcommand mcpdeskcommand 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:

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

Docker

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

Development

bash
npm installnpm run buildnpm test

MIT license.

來源：README.md，提交 7e7abb9

工具

26

create_directory

Create a new directory or ensure a directory exists, including nested paths

輸入參數path必填

edit_block

Apply a surgical text replacement in a file: replace old_string with new_string

輸入參數file_path必填new_string必填old_string必填expected_replacements

force_terminate

Force terminate a running terminal process session

輸入參數pid必填

get_config

Get the current server configuration

無需輸入參數。

get_file_info

Retrieve detailed metadata about a file or directory

輸入參數path必填

get_more_search_results

Get more results from an active search session

輸入參數lengthoffsetsessionId必填

get_prompts

Get available prompts, or one prompt by id

輸入參數promptId

get_recent_tool_calls

Get the recent tool calls recorded by this server

無需輸入參數。

get_usage_stats

Get usage statistics for this server

無需輸入參數。

give_feedback_to_desktop_commander

Record feedback about this tool for later review

輸入參數message必填

interact_with_process

Send input to a running process and wait for its response

輸入參數pid必填input必填timeout_ms

kill_process

Terminate a process by its PID

輸入參數pid必填

list_directory

Get a detailed listing of all files and directories at a path

輸入參數path必填

list_processes

List all running processes with their PID, command and status

無需輸入參數。

list_searches

List all active search sessions

無需輸入參數。

list_sessions

List all active terminal sessions

無需輸入參數。

move_file

Move or rename a file or directory

輸入參數source必填destination必填

read_file

Read the complete contents of a file, optionally a line range

輸入參數path必填lengthoffset

read_multiple_files

Read the contents of multiple files simultaneously

輸入參數paths必填

read_process_output

Read output from a running process, waiting up to a timeout for new output

輸入參數pid必填timeout_ms

set_config_value

Set a configuration value by key

輸入參數key必填value必填

start_process

Start a new terminal process in a shell and return its initial output

輸入參數shellcommand必填timeout_ms

write_file

Create a new file or completely overwrite an existing file with new content

輸入參數path必填content必填

write_pdf

Write text content to a file at a path (PDF-oriented in the original; this rebuild writes the content as given)

輸入參數path必填content必填

版本歷史

1
  1. v0.1.0最新Oct 31, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分