mcpField
D
deskcommand

deskcommand

本地服务
github.com/CloudCorpRecords开发工具02 周前更新
代码仓库

关于 deskcommand

deskcommand 为命令行用户和 MCP 客户端提供本机操作工具，涵盖终端进程控制、文件操作和分阶段返回的代码搜索，并附带配置与使用情况工具。

主要功能

  1. 01启动并控制终端进程
  2. 02读取、写入、移动和编辑文件
  3. 03搜索文件内容并分页查看
  4. 04检查配置与近期调用

适用场景

  1. 01运行并查看本机终端进程
  2. 02对项目文件进行精确文本编辑
  3. 03搜索本机目录树并逐页查看结果

MCP 相关

stdio MCP 服务提供 26 个工具，用于操作本机进程和文件、搜索内容，以及查看配置和使用情况。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "cloudcorprecords-deskcommand": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/deskcommand"
      ]
    }
  }
}
启动命令npx -y @reneturcios/deskcommand

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@reneturcios/deskcommand0.1.0
ocighcr.io/cloudcorprecords/deskcommand:0.1.0

工具

26

收录的工具列表 · 更新于 2 周前

参数类型必填说明
pathstring是要创建或确保存在的目录路径

详细介绍

deskcommand

通过命令行或作为 stdio MCP 服务在本地计算机上工作：启动并驱动终端进程、读取和写入文件、精确编辑文本、移动文件、检查元数据并搜索文件内容，同时还提供配置、用法和近期调用工具。

文件系统和搜索都采用真正的本地实现。搜索以会话方式运行：start_search 遍历目录树（跳过 node_modules、.git 和 dist），并返回一个会话 ID，其结果可通过 get_more_search_results 分页获取。edit_block 会替换完全匹配的文本块，并拒绝有歧义的编辑；若某个文本块出现多次，则需要明确指定预期次数。终端进程由可注入的执行器运行；默认执行器会启动真实的 shell 进程并缓冲其输出，因此 read_process_output 只会返回你尚未查看的输出。

与本项目所模仿的工具集相比，有两处坦诚的简化：write_pdf 会原样写入给定内容（没有 PDF 排版引擎），而搜索是在进程内同步执行的，不会从 ripgrep 子进程流式读取结果。

安装

npx -y @reneturcios/deskcommand mcp

CLI

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

退出代码：0 表示成功，1 表示操作错误，2 表示用法错误。

MCP 工具

26 个工具：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 客户端配置：

{
  "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

开发

npm install
npm run build
npm test

MIT 许可证。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。