克劳德本地控制
通过Claude代码直接控制您本地真实PC的MCP服务器
通过模型上下文协议（MCP），使用Claude Code控制您的真实电脑——鼠标、键盘、截图、命令行、文件编辑——一切尽在掌控。
🎯 这是什么？
这是一台MCP服务器，允许Claude Code进行控制 您的真实本地电脑直接:
- 🖱️ 鼠标和键盘控制
- 📸 每次操作自动截图
- 🐚 持久化的Bash shell会话
- 📝 实际文件系统文件编辑
- 🖥️ 所有操作都在您的真实屏幕上进行
对比 Docker 版本
这个项目是基于claude-desktop-control改编的，但它不是在独立的Docker容器中运行，而是 控制你真实的本地机器。
| 方面 | Docker 版本 | 本地版本（本项目） | ||||
|---|---|---|---|---|---|---|
| 项目 | 类别 | 描述 | ** | 环境 | 隔离容器 | ** 您的真实电脑 |
| ** | 显示 | Xvfb 虚拟显示 | ** 你的实际显示器 | |||
| (Xwayland :0) | ** | 文件 | 容器文件系统 | ** 你的实际文件系统 | ||
| ** | 安全 | 隔离 | ** 对您的系统拥有完全访问权限 | |||
| ** | 用例 | 安全实验 | ** 实际的生产力任务 |
|
🚀 快速入门
- 先决条件
- 带有X11/Xwayland的Ubuntu/Debian Linux
- Node.js 和 npm
- Python 3.10+（或 Python 3.10及以上版本）
Claude CLI 命令行接口
# 1. Clone the repository
cd ~/Personal
git clone https://github.com/YOUR_USERNAME/claude-local-control.git
cd claude-local-control
# 2. Run the installer (installs dependencies, creates venv, compiles MCP)
./install.sh
# 3. Add MCP to Claude Code
claude mcp add local-control -- bash ~/Personal/claude-local-control/start-mcp.sh
# 4. Verify installation
claude mcp list
# Should show: local-control: ... - ✓ Connected
# 5. IMPORTANT: Restart Claude Code if it was already running
# (for the MCP to be fully activated)安装
使用方法
/local
[Your task here]在Claude Code中，激活本地控制模式： /local 这个（或：那个）
该命令会自动加载适当的上下文以控制您的真实电脑。
🛠️ 可用工具 computer 1.
\- 电脑控制
- 使用鼠标、键盘和截图功能控制您的真实电脑：屏幕截图
- 捕捉您的真实屏幕鼠标移动
- 将鼠标移动到坐标 \[x, y\]左键点击 ，右键点击 ，中键点击
- 鼠标点击双击 ，三击
- 多次点击左键点击并拖动
- 从当前位置拖动到 \[x, y\]钥匙
- 按下键/组合键（例如，“回车”，“ctrl+c”）类型
- 输入文本滚动
- 向指定方向滚动指定距离光标位置
- 获取当前光标位置等一下
等待N秒并截取屏幕截图✨ 关键特性
每个操作都会自动返回一张显示结果的截图。 bash 2.
\- 持久性外壳（或持久会话）
- 在您实际系统上保持持久的Bash会话：
- 工作目录在命令之间保持不变
- 维护的环境变量
- 以您的实际用户身份运行
完全访问您的文件系统 str_replace_editor 3.
\- 文件编辑器 在您的设备上编辑文件真实文件系统
- ：视图
- 查看文件或列出目录创造；创建
- 创建新文件str_replace（在中文中，这通常被理解为“字符串替换”的意思，但直接翻译该英文词汇为中文时，可保持为“str_replace”，因为这是一个特定的编程函数名，不直接对应中文的某个短语）
- 替换文件中的文本插入
- 在行号处插入文本撤销编辑
撤销上一次编辑 ⚠️警告
在您的真实系统上，更改是永久性的。
🧠 何时使用什么 computer 使用
- (MCP 工具) 当：
- ✅ 你需要与图形用户界面（GUI）应用程序进行交互
- ✅ 预订酒店，安排住宿，进行在线购物
- ✅ 需要进行视觉验证
- ✅ 使用桌面应用程序（Firefox、LibreOffice、计算器等）
- ✅ 复杂的导航设计，阻挡机器人
✅ 任何需要“看并点击”的操作
- 在以下情况下使用Claude Code原生工具：
WebFetch✅ 网络爬虫/数据提取（WebSearch， - ）
- ✅ 代码生成，CSV文件创建，数据处理
- ✅ 快速信息搜索
- ✅ 在主机上进行文件操作
Read✅ 阅读/分析文件 (Grep，Glob，
)
- 当以下情况时，使用HYBRID策略： 生成内容
- 使用原生工具（快速） 转移
~/claude-local-workspace/ - 通过工作区 格式/呈现
computer和；与；带有
在桌面应用程序中
⚡ 效率提升策略
脚本 > 点击❌ 差
在Excel中通过逐一点击创建1000行（耗时10小时）✅ 好
# Generate CSV with Python (30 seconds)
bash({ command: `python3 Open, select CSV：
文件传输工作区 ~/claude-local-workspace/ 使用
在原生工具和桌面应用程序之间传输文件。
claude-local-control/
├── tools/ # Python MCP tools
│ ├── computer.py # Screen control (adapted for local)
│ ├── bash.py # Persistent shell
│ └── edit.py # File editor
├── mcp-server/ # Node.js MCP server
│ ├── src/
│ │ ├── index.ts # MCP server entry point
│ │ ├── bridge.ts # Python-Node.js bridge (adapted)
│ │ └── tools/ # Tool definitions
│ └── package.json
├── .claude/
│ └── commands/
│ └── local.md # /local slash command
├── install.sh # Installation script
├── start-mcp.sh # MCP launcher (created by install.sh)
├── CLAUDE.md # Complete usage guide
├── EXAMPLES.md # Practical examples
└── README.md # This file📁 项目结构
🔒 安全考量 ⚠️（注意/警告）重要警告
： 这个MCP具有全面访问您的真实电脑
- :
- 可以以您的用户身份执行任何命令
- 可以读取/修改您有权访问的任何文件
- 可以在真实屏幕上控制鼠标/键盘
能看到你所看到的一切
仅在你信任Claude执行的任务中使用此功能。
与Docker版本不同，这里没有隔离或沙盒机制。所有操作都会直接在您的真实系统上执行。
- 📊 系统信息显示
$DISPLAY自动检测来自:0环境（通常 - )决心
xrandr通过自动检测 - （备用分辨率：1920x1080）工作区
~/claude-local-workspace/： - （用于文件传输）屏幕截图
/tmp/claude-local-outputs/ - :Python 虚拟环境（venv）
~/.claude-local-venv/ - ：用户
您实际的系统用户
- 📚 文档CLAUDE.md（文件名，可译为“克劳德文档”或保持原样，具体根据上下文决定是否翻译文件名）
- 使用该系统的完整指南EXAMPLES.md 翻译为中文是：“示例.md”（注：.md 通常表示这是Markdown格式的文件，但在此处作为文件名的一部分，直接翻译为“示例”即可，不特别指出其格式）
- 包含正确/错误策略的详细示例.claude/commands/local.md（文件路径，直译为“claude/命令/本地.md”，但具体含义需结合上下文理解，通常表示这是某个名为“claude”的项目或系统中关于本地命令的说明文件）
/local：
命令文档
🎓 哲学
“采用智能策略优化速度，但务必始终完成100%的请求工作。Claude Sonnet 4.5可连续工作长达7小时——没有理由留下未完成的工作。”
- 基本原则： 🧠 表示“大脑”或“思考”的意思，但在此作为单独的符号使用时，通常不直接翻译为具体的文字，而是根据上下文理解为与“思维”、“智慧”或“大脑”相关的概念。如果需要一个简单的对应词，可以理解为“智慧”或“思考”。不过，在实际应用中，这个符号往往保留其原样，以传达一种直观的感觉或暗示。 超薄（或极简设计）
- 在行动之前——选择最佳策略 📸（相机或拍照的含义，可单独用作表情符号表示拍照或相机） 总是开始
- 附上截图以查看当前状态 ⚡（闪电符号，无特定含义，常用于表示速度、能量或警告） 优化 但总是 完成
- 全部任务 🎯（瞄准目标） 100%完成
- \- 永远不要放弃部分已完成的工作 🔒（锁形符号，常用于表示安全、保密或锁定状态） 小心
- 这是你的真电脑
🛠️ 开发
cd mcp-server
npm install
npm run build构建MCP服务器
测试
# In a new Claude Code session
/local
# Test 1: Screenshot
computer({ action: "screenshot" })
# Test 2: Mouse movement
computer({ action: "mouse_move", coordinate: [960, 540] })
# Test 3: Bash
bash({ command: "pwd && whoami" })
# Test 4: File editor
str_replace_editor({ command: "view", path: "/home/chelu/.bashrc" })安装完成后，您可以测试每个工具：
🤝 贡献
这是一个对Anthropic计算机使用演示的个人改编版本。欢迎随意进行分支开发并根据自己的需求进行调整。
📄 许可证
基于Anthropic的计算机使用演示，已适配本地系统控制。
⚠️ 免责声明
______________________________________________________________________
这个工具允许Claude Code直接控制您的真实计算机。请负责任地使用它，仅用于您信任的任务。作者不对任何意外操作或系统修改负责。
/local
What should I do on your computer?