Claudedesktopcommander

🚀 桌面指挥官MCP

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

🚀 快速开始

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

✨ 主要特性

• 终端命令执行：支持输出流的终端命令执行，具备命令超时和后台执行功能。
• 进程管理：可列出和终止进程，支持长时间运行命令的会话管理。
• 文件系统操作：涵盖文件读写、目录创建与列出、文件/目录移动、文件搜索、文件元数据获取等完整操作。
• 代码编辑能力：支持小范围的精确文本替换和大范围的文件重写，支持多文件和基于模式的替换。

📦 安装指南

首先，确保你已下载并安装 Claude桌面应用程序，并且已安装 npm。

选项1：通过Smithery安装

要通过 Smithery 自动为Claude桌面应用程序安装桌面指挥官，请运行以下命令：

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正在运行，请重启它。

设置命令将执行以下操作：

• 安装依赖项
• 构建服务器
• 配置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
existing code to replace
=======
new code to insert
>>>>>>> REPLACE

示例：

src/main.js
<<<<<<< SEARCH
console.log("old message");
=======
console.log("new message");
>>>>>>> REPLACE

高级用法

处理长时间运行的命令

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

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

📚 详细文档

模型上下文协议集成

本项目扩展了MCP文件系统服务器，以实现以下功能：

• Claude桌面应用程序的本地服务器支持
• 完整的系统命令执行
• 进程管理
• 文件操作
• 使用搜索/替换块进行代码编辑

此项目是探索Claude MCP的一部分：https://youtube.com/live/TlbjFDbl5Us

开发进度和待办事项

以下功能正在开发或计划中：

• 更强大的代码搜索 (开发中) - 增强代码探索，提供上下文感知的搜索结果。
• 更完善的配置 (开发中) - 改进允许路径、命令和shell环境的设置。
• Windows环境修复 (开发中) - 解决特定于Windows平台的问题。
• Linux兼容性增强 (开发中) - 提高与各种Linux发行版的兼容性。
• WSL支持 - 支持Windows子系统Linux。
• SSH支持 - 支持远程服务器命令执行。
• 安装故障排除指南 - 提供全面的安装问题帮助。

媒体链接

通过以下资源了解更多关于本项目的信息：

• 文章：Claude with MCPs replaced Cursor & Windsurf. How did that happen? - 详细探讨了具备模型上下文协议功能的Claude如何改变开发者的工作流程。
• 视频：Claude Desktop Commander Video Tutorial - 观看如何有效设置和使用指挥官。
• 社区：加入我们的 Discord服务器 以获取帮助、分享反馈并与其他用户交流。

用户评价

• 用户评价1
• 用户评价2
• 用户评价3
• 用户评价4
• 用户评价5

贡献指南

如果你觉得这个项目有用，请在GitHub上给它点个 ⭐ 星星！这有助于其他人发现该项目并鼓励进一步开发。

我们欢迎社区的贡献！无论你是发现了一个bug、有一个功能请求，还是想贡献代码，都可以通过以下方式提供帮助：

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

所有贡献，无论大小，都非常感谢！

如果你觉得这个工具对你的工作流程有价值，请考虑 支持该项目。

📄 许可证

本项目采用MIT许可证。