使用说明

项目简介

Claude Computer Commander 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在使 AI 助手（如 Claude）能够与您的本地计算机终端进行交互。通过此服务器，Claude 可以执行 Shell 命令、管理运行中的进程，并获取命令输出，从而扩展了 AI 助手在本地系统上的操作能力。

主要功能点

执行终端命令: 允许 AI 助手在您的计算机上执行各种终端命令，并将命令输出流式传输回 AI 助手。
超时与后台执行: 支持为命令设置执行超时时间。超过超时时间的命令可以继续在后台运行，允许处理耗时任务。
进程管理: 提供列出和终止运行中进程的功能，使 AI 助手能够监控和控制系统进程。
会话管理: 针对长时间运行的命令，提供会话管理功能，可以跟踪命令的执行状态并获取最新的输出。
命令黑名单: 支持配置命令黑名单，阻止执行不安全的或未授权的命令，提高系统安全性。

安装步骤

克隆仓库:

git clone https://github.com/MCP-Mirror/wonderwhy-er_ClaudeComputerCommander.git
cd ClaudeComputerCommander

构建和设置服务器:
```
npm run setup
```
此命令将自动完成以下操作：
- 安装项目依赖。
- 构建服务器代码。
- 检查 Claude 桌面应用的配置文件是否存在，不存在则创建默认配置。
- 将 MCP 服务器配置添加到 Claude 的配置文件中（如果尚未添加）。
- 同时集成 Puppeteer 浏览器自动化服务器和文件编辑服务器。
重启 Claude 桌面应用: 安装完成后，重启 Claude 桌面应用以加载新的服务器配置。

服务器配置

Claude 桌面应用需要配置 MCP 服务器的启动命令和参数才能连接到 Claude Computer Commander 服务器。'npm run setup' 命令会自动尝试配置，以下是服务器配置信息示例，您可以在 Claude 桌面应用的 MCP 服务器配置中找到或手动添加（通常位于 Claude 桌面应用的设置中）：

{
  "serverName": "terminal",
  "command": "node",
  "args": [
    "path/to/ClaudeComputerCommander/dist/index.js"
  ]
}

注意: 'path/to/ClaudeComputerCommander' 需要替换为 ClaudeComputerCommander 项目在您计算机上的实际路径。通常 'npm run setup' 脚本会自动处理路径配置。

基本使用方法

配置完成后，您可以在 Claude 中使用以下工具与您的计算机终端进行交互：

'execute_command': 执行终端命令。
'read_output': 获取正在运行的命令的最新输出（通过 PID）。
'force_terminate': 强制终止正在运行的命令会话（通过 PID）。
'list_sessions': 列出所有活跃的命令会话。
'list_processes': 列出当前系统所有运行中的进程。
'kill_process': 终止指定的进程（通过 PID）。
'block_command': 将命令添加到黑名单，阻止执行。
'unblock_command': 从黑名单移除命令，允许执行。
'list_blocked_commands': 列出当前黑名单中的命令。

在 Claude 中，您可以指示 Claude 使用这些工具来执行相应的操作，例如让 Claude 运行 'ls -l' 命令查看目录内容，或者使用 'kill_process' 终止某个失响应的进程。

关键词