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 分