使用说明

项目简介

Desktop Commander MCP 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在增强 Claude Desktop 应用程序的功能，使其能够与您的本地计算机进行更深入的交互。通过 Desktop Commander MCP，Claude 可以执行终端命令、管理本地文件系统以及进行代码编辑，从而实现更强大的自动化和辅助编程能力。

主要功能点

终端命令执行：允许 Claude 执行终端命令，并实时获取命令输出，支持长时间运行的命令和进程管理。
进程管理：可以列出和终止正在运行的系统进程。
文件系统操作：支持文件的读取、写入、创建目录、移动文件、搜索文件以及获取文件信息等操作。
代码编辑：提供基于搜索和替换块的代码编辑功能，方便 Claude 对代码进行小范围修改或大规模重写。

安装步骤

您可以通过以下几种方式安装 Desktop Commander MCP：

方法一：使用 Smithery 安装 (推荐)

如果您安装了 Smithery CLI，可以使用以下命令快速安装：

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

方法二：使用 npx 安装

在终端中运行以下命令即可安装：

npx @wonderwhy-er/desktop-commander setup

方法三：手动配置 Claude Desktop

找到 Claude Desktop 的配置文件 'claude_desktop_config.json'。该文件通常位于：
- macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%\Claude\claude_desktop_config.json'

编辑 'claude_desktop_config.json' 文件，在 'mcpServers' 字段下添加以下配置：

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

方法四：本地检出源码安装

克隆仓库到本地：

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

运行安装脚本：
```
npm run setup
```

服务器配置

对于 MCP 客户端（如 Claude Desktop），您需要配置 MCP 服务器的启动信息。以下是 Desktop Commander MCP 的典型配置，通常在安装过程中会自动完成，手动配置时可参考：

{
  "mcpServers": {
    "desktop-commander": {
      "command": "npx",  // 启动命令，通常使用 npx 运行 npm 包
      "args": [         // 命令参数
        "-y",           // npx 参数，自动确认安装包
        "@wonderwhy-er/desktop-commander" // 要运行的 npm 包名
      ]
    }
  }
}

基本使用方法

安装并配置完成后，重启 Claude Desktop 应用程序。Desktop Commander MCP 提供的工具将会在 Claude 中可用。您可以指示 Claude 使用以下工具来完成各种任务：

终端工具：'execute_command'（执行命令）, 'read_output'（读取输出）, 'force_terminate'（终止会话）等，用于执行和管理终端命令。
文件系统工具：'read_file'（读取文件）, 'write_file'（写入文件）, 'create_directory'（创建目录）等，用于文件和目录的管理。
编辑工具：'edit_block'（编辑代码块），用于对代码文件进行精确修改。

具体工具的使用方法和参数说明，请参考仓库的 README.md 文件或项目文档。

关键词

使用说明

信息