🚀 桌面指挥官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：本地检出
- 克隆并构建项目：
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
高级用法
处理长时间运行的命令
对于可能需要一段时间才能完成的命令：
execute_command在超时后返回初始输出。- 命令在后台继续运行。
- 使用
read_output和PID获取新的输出。 - 如果需要，使用
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服务器 以获取帮助、分享反馈并与其他用户交流。
用户评价
贡献指南
如果你觉得这个项目有用，请在GitHub上给它点个 ⭐ 星星！这有助于其他人发现该项目并鼓励进一步开发。
我们欢迎社区的贡献！无论你是发现了一个bug、有一个功能请求，还是想贡献代码，都可以通过以下方式提供帮助：
- 发现bug：在 github.com/wonderwhy-er/ClaudeComputerCommander/issues 上提交一个问题。
- 有功能想法：在问题部分提交一个功能请求。
- 想贡献代码：分叉仓库，创建一个分支，并提交一个拉取请求。
- 有问题或讨论：在GitHub讨论标签中发起一个讨论。
所有贡献，无论大小，都非常感谢！
如果你觉得这个工具对你的工作流程有价值，请考虑 支持该项目。
📄 许可证
本项目采用MIT许可证。