Kilnshell

为 AI Agent 提供整台机器，无需等待。

通过 MCP 使用终端、文件、代码搜索、长时间运行的进程、PDF、Excel 和 Word。
提供 Desktop Commander 的所有功能，每次调用速度最高提升 100 倍；不进行遥测，也不会向 Agent 的上下文注入任何内容。

---

基准测试

工具调用	Desktop Commander 0.3.1	Kilnshell	提速
运行命令（echo hi）	696.7 ms	5.7 ms	122 倍
运行命令（git --version）	703.7 ms	16.2 ms	43 倍
读取一个 2 万行文件中的 1,000 行	41.9 ms	3.2 ms	13 倍
编辑一行（edit_block）	75.7 ms	6.9 ms	11 倍
写入文件	34.7 ms	1.0 ms	35 倍
文件信息	21.8 ms	1.2 ms	18 倍
列出目录	19.2 ms	1.4 ms	14 倍
一次读取 10 个文件	191.8 ms	3.5 ms	55 倍

测试环境为 MacBook Pro（Apple Silicon）、macOS、使用典型开发者配置文件（Homebrew 和 nvm）的 zsh、Node 25；通过真实 MCP stdio 测量 9 次调用的中位数，且已在 Desktop Commander 配置中关闭遥测。命令提速取决于你的 shell 配置文件：配置文件越复杂，提速越明显。在配置文件为空的基础 Linux 机器上，命令速度约提升 3 倍，文件工具速度约提升 3 到 6 倍。

在你的机器上复现：

git clone https://github.com/Soflutionltd/kilnshell && cd kilnshell
npm install
npm run bench        # installs Desktop Commander 0.3.1 next to it, runs both, redraws the chart

有哪些变化，以及为什么更快

Kilnshell 最初是基于 Desktop Commander 0.3.1 克隆而来，并逐个调用进行性能分析。

1. Shell 配置文件只读取一次，而不是每次执行命令时都读取。 Desktop Commander 会以 zsh -l -c ... 启动每个命令，因此加载 nvm、pyenv 或 Homebrew 的配置文件会让每个命令耗时 0.5 到 1 秒。Kilnshell 会在启动时运行一次登录配置文件，保留其生成的环境（相同的 PATH 和变量），并以 zsh -c 启动每个命令。设置 DESKTOP_COMMANDER_LOGIN_ENV_CACHE=0，即可每次都启动新的登录 Shell。
2. 每次调用时都不会在后台偷偷启动进程。 遥测功能会为每次工具调用重新生成系统报告，同步运行 python3 --version，即使关闭了遥测，也会让服务冻结 10 到 25 毫秒。现在系统信息只计算一次。
3. 行数统计使用原生字符串扫描。 读取、编辑和检查文件时，原本会逐字符统计行数；新的计数方式结果完全相同（已在 200,000 个随机输入上验证），处理大型文件时速度约快 11 倍。
4. 不再输出调试噪声。 过去每次调用都会向客户端推送两到四条 [FEEDBACK DEBUG] 日志通知。
5. 减少往返次数。 对 Agent 来说，每次工具调用都要完整往返一次，耗时往往远超命令本身。Kilnshell 新增了：
   • batch：在一个请求中执行多个工具调用（命令、读取、编辑、搜索），并按顺序为结果编号；
   • read_process_output 搭配 wait_for_exit: true：等待进程结束并一次性返回其全部输出，无需轮询；
   • start_search 搭配 wait: true：一次调用返回所有结果，无需先调用 start_search，再调用 get_more_search_results；
   • wait_for：等待端口接受连接、文件存在、URL 返回响应或进程退出，无需循环休眠。
6. 在 Claude Desktop 中也能全速运行。 Claude Desktop 会在自己的 Node 中运行扩展；环境通过 env -0 捕获，因此配置文件缓存也能在那里正常工作，并且 Claude 的 ELECTRON_* 变量不会传递给你的命令。

移除了什么

上游行为	Kilnshell
向 Desktop Commander 服务器发送使用情况遥测数据	已移除。Kilnshell 不会自行发起网络请求。
每 5 分钟从 desktopcommander.app 下载功能标志	仅使用内置默认值（可通过 KILNSHELL_FLAG_URL 托管自己的标志）。
附加到工具结果末尾的 [SYSTEM INSTRUCTION] 文本，要求模型请求反馈或推广 Docker 设置	已移除。工具结果只包含工具的输出。
首次运行时在浏览器中打开欢迎页	已移除。
give_feedback_to_desktop_commander 工具	已隐藏。
remote 模式（依赖 Desktop Commander 云服务）	不可用。

其他部分都是相同的代码：相同的工具、相同的参数、相同的配置文件（~/.claude-server-commander/config.json），因此 Kilnshell 可以直接替换原版。新增工具和选项仅为补充。

安装

Claude Desktop： 下载 kilnshell.mcpb，然后双击（或前往 Settings > Extensions > Advanced settings > Install Extension）。之后，Kilnshell 图标会显示在每次工具调用旁边。

Claude Code： /plugin install kilnshell --marketplace Soflutionltd/kilnshell

它也已列入官方 MCP Registry，名称为 com.soflution/kilnshell。

Cursor 或任何 MCP 客户端：

{
  "mcpServers": {
    "kilnshell": {
      "command": "npx",
      "args": ["-y", "github:Soflutionltd/kilnshell"]
    }
  }
}

也可从本地克隆运行，启动速度比 npx 更快：

git clone https://github.com/Soflutionltd/kilnshell && cd kilnshell && npm install

{ "mcpServers": { "kilnshell": { "command": "node", "args": ["/absolute/path/to/kilnshell/dist/index.js"] } } }

工具

区域	工具
速度	batch（一次发起多个调用）、wait_for（等待端口、文件、URL 或进程）
终端	start_process、interact_with_process、read_process_output（wait_for_exit）、list_sessions、list_processes、force_terminate、kill_process
文件	read_file、read_multiple_files、write_file、edit_block、create_directory、list_directory、move_file、get_file_info
搜索	start_search（wait）、get_more_search_results、stop_search、list_searches（ripgrep）
文档	write_pdf，以及通过 read_file、write_file 和 edit_block 读取和编辑 PDF、Excel 和 Word 文件
配置	get_config、set_config_value、get_usage_stats、get_recent_tool_calls

安全控制保持不变：allowedDirectories、blockedCommands、文件读写行数限制，均在配置文件中设置。

开发

npm install
npm run build
npm test            # the full upstream test suite (takes several minutes)
npm run bench       # Kilnshell vs Desktop Commander on this machine

致谢与许可证

Kilnshell 基于 Eduard Ruzga 和 Desktop Commander 贡献者开发的 Desktop Commander 构建，并根据 MIT 许可证发布。本仓库保留了他们的完整历史记录。Kilnshell 是一个独立项目，与他们无关联，也未获他们认可。

MIT，© 2024-2025 Eduard Ruzga 和 Desktop Commander 贡献者，© 2026 Soflution Ltd。详见 LICENSE。

法语版

Kilnshell 是一款 MCP 服务，可让 AI Agent 访问你的机器：终端、文件、代码搜索、进程、PDF、Excel 和 Word。它是 Desktop Commander 的克隆版本，针对每次调用进行了优化：在开发者 Mac 上速度最高可快 100 倍，不包含任何遥测，也不会在发给 Agent 的回复中注入广告文案。只需在 Claude 的配置中替换一行即可。