Repolode
wonderwhy-er

wonderwhy-er/DesktopCommanderMCP

为 Claude 等 AI 客户端提供终端控制、文件搜索、差异编辑及文档处理能力的 MCP 服务器。

Star
10,105
Fork
1,290
未关闭 Issue
315
最近提交
16小时前

这是什么?

Desktop Commander 是一个 MCP(Model Context Protocol)服务器,让 Claude Desktop、Cursor、VS Code、Gemini CLI 等 AI 客户端可以在运行它的电脑上执行终端命令、管理进程并处理文件。它基于 MCP Filesystem Server 构建,增加了搜索和基于替换的文件编辑功能,使 AI 能够针对性地修改代码,而不必整体重写文件。

除了 shell 命令,它还能启动 Python、Node.js、SSH 等交互式程序,并分页读取输出。它支持读写 Excel、PDF 和 DOCX 文件,并为 Claude Desktop 提供带 Markdown 编辑器的文件预览面板。工具调用记录会保存在本地磁盘上,远程设备模式则允许网页端的 AI 服务在本机运行期间向其发送指令。

服务器提供可配置的安全措施,包括命令黑名单、允许访问的目录列表以及符号链接遍历检查。项目的安全文档说明这些措施并非沙箱,如需隔离可使用 Docker 安装方式。

核心功能

  • 01运行终端命令和交互式程序,支持输出分页与后台执行
  • 02搜索文件及文件内容,包括文本和 Excel 数据
  • 03支持针对性的查找替换编辑以及整文件重写
  • 04读写 Excel、PDF 和 DOCX 文件
  • 05Claude Desktop 中的文件预览面板,内置 Markdown 编辑器
  • 06远程设备模式,可将网页端 AI 服务连接到本机

适用场景

  • 让 AI 助手对本地项目进行小步、可审阅的代码重构
  • 借助内存中运行的 Python 代码分析 CSV、JSON 或 Excel 文件
  • 在 AI 对话中操作 SSH 会话或开发服务器
  • 在个人电脑上自动整理文件或转换文档格式

快速上手

  1. 1

    安装 Node.js 后运行安装命令

    npx @wonderwhy-er/desktop-commander@latest setup
  2. 2

    如果 Claude Desktop 正在运行,请重启它

使用前须知

  • 不是沙箱,它可以在你的机器上执行终端命令并访问文件。
  • 本地检出安装方式(选项 5)需要手动通过 git 更新。

标签

常见问题

DesktopCommanderMCP 是什么?
为 Claude 等 AI 客户端提供终端控制、文件搜索、差异编辑及文档处理能力的 MCP 服务器。 Desktop Commander 是一个 MCP(Model Context Protocol)服务器,让 Claude Desktop、Cursor、VS Code、Gemini CLI 等 AI 客户端可以在运行它的电脑上执行终端命令、管理进程并处理文件。它基于 MCP Filesystem Server 构建,增加了搜索和基于替换的文件编辑功能,使 AI 能够针对性地修改代码,而不必整体重写文件。
DesktopCommanderMCP 可以免费使用吗?用的什么许可证?
DesktopCommanderMCP 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
DesktopCommanderMCP 还在维护吗?
活跃维护中。DesktopCommanderMCP 最近一次提交是在 2026年10月19日。
DesktopCommanderMCP 适合用来做什么?
让 AI 助手对本地项目进行小步、可审阅的代码重构 借助内存中运行的 Python 代码分析 CSV、JSON 或 Excel 文件 在 AI 对话中操作 SSH 会话或开发服务器 在个人电脑上自动整理文件或转换文档格式
DesktopCommanderMCP 怎么安装和运行?
安装 Node.js 后运行安装命令: npx @wonderwhy-er/desktop-commander@latest setup 如果 Claude Desktop 正在运行,请重启它
在哪里获取 DesktopCommanderMCP?
源代码和安装说明在 GitHub 上:https://github.com/wonderwhy-er/DesktopCommanderMCP

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目