Claude Desktop Commander MCP

简短版本。两个关键点。终端命令和基于差异的文件编辑。

<a href="https://glama.ai/mcp/servers/zempur9oh4"> <img width="380" height="200" src="https://gips3.baidu.com/it/u=1001839438,1059971023&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Claude Desktop Commander MCP 服务器" /> </a>

这是一个允许 Claude 桌面应用程序在您的计算机上执行长时间运行的终端命令并通过模型上下文协议（MCP）管理进程的服务器。该服务器基于 MCP 文件系统服务器，提供了额外的搜索和替换文件编辑功能。

功能

• 执行带有输出流的终端命令
• 支持命令超时和后台执行
• 进程管理（列出和终止进程）
• 长时间运行命令的会话管理
• 完整的文件系统操作：
  • 读写文件
  • 创建/列出目录
  • 移动文件/目录
  • 搜索文件
  • 获取文件元数据
  • 编辑代码的能力：
  • 对小改动进行精准文本替换
  • 对重大改动进行完整的文件重写
  • 支持多个文件
  • 基于模式的替换

安装

首先，请确保您已下载并安装了 Claude 桌面应用 并且已经安装了 npm。

方案 1：通过 Smithery 安装

要通过 Smithery 自动安装 Claude Desktop Commander：

npx -y @smithery/cli install @wonderwhy-er/desktop-commander --client claude

方案 2：通过 npx 安装

只需在终端中运行以下命令：

npx @wonderwhy-er/desktop-commander setup

如果正在运行，请重启 Claude

方案 3：手动添加到 claude_desktop_config

将以下条目添加到您的 claude_desktop_config.json 中（在 Mac 上，位于 ~/Library/Application\ Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "desktop-commander": {
      "command": "npx",
      "args": [
        "-y",
        "@wonderwhy-er/desktop-commander"
      ]
    }
  }
}

如果正在运行，请重启 Claude

方案 4：本地检出

1. 克隆并构建：

git clone https://github.com/wonderwhy-er/ClaudeComputerCommander.git
cd ClaudeComputerCommander
npm run setup

如果正在运行，请重启 Claude

setup 命令将：

• 安装依赖项
• 构建服务器
• 配置 Claude 的桌面应用
• 如果需要，将 MCP 服务器添加到 Claude 的配置中

使用

该服务器提供这些工具类别：

终端工具

• execute_command：运行可配置超时的命令
• read_output：获取长时间运行命令的输出
• force_terminate：停止运行中的命令会话
• list_sessions：查看活跃的命令会话
• list_processes：查看系统进程
• kill_process：通过 PID 终止进程
• block_command/unblock_command：管理命令黑名单

文件系统工具

• read_file/write_file：文件操作
• create_directory/list_directory：目录管理
• move_file：移动/重命名文件
• search_files：基于模式的文件搜索
• get_file_info：文件元数据

编辑工具

• edit_block：应用精准文本替换（适用于小于文件大小 20% 的更改）
• write_file：完整的文件重写（适用于大于 20% 的大更改或当 edit_block 失败时）

搜索/替换块格式：

filepath.ext
<<<<<<< SEARCH
现有代码以替换
=======
新代码以插入
>>>>>>> REPLACE

示例：

src/main.js
<<<<<<< SEARCH
console.log("旧消息");
=======
console.log("新消息");
>>>>>>> REPLACE

处理长时间运行的命令

对于可能需要一段时间的命令：

1. execute_command 在超时后返回初始输出
2. 命令继续在后台运行
3. 使用 read_output 和 PID 获取新的输出
4. 如需停止，使用 force_terminate

模型上下文协议集成

此项目扩展了 MCP 文件系统服务器，以实现：

• 在 Claude Desktop 中支持本地服务器
• 完整的系统命令执行
• 进程管理
• 文件操作
• 带有搜索/替换块的代码编辑

作为探索 Claude MCP 的一部分创建：https://youtube.com/live/TlbjFDbl5Us

贡献

如果您发现这个项目有用，请考虑在 GitHub 上给它一个 ⭐ 星！这有助于其他人发现该项目，并鼓励进一步的发展。

我们欢迎来自社区的贡献！无论您发现了错误、有功能请求，还是想贡献代码，这里是如何帮助的方法：

• 发现错误？ 在 github.com/wonderwhy-er/ClaudeComputerCommander/issues 开启一个问题
• 有功能想法？ 在问题部分提交功能请求
• 想贡献代码？ 分叉仓库，创建分支，并提交拉取请求
• 问题或讨论？ 在 GitHub 讨论标签中开始讨论

所有贡献，无论大小，都深表感谢！

许可证

MIT