内容
# pc-control-mcp
一款Model Context Protocol（MCP）服务器，赋予Claude对Windows的完全PC控制权限：鼠标、键盘、截图、窗口管理、浏览器自动化、笔记和剪贴板。
30多种工具，涵盖：
- **鼠标和键盘** — 点击、拖拽、滚动、输入、快捷键
- **截图** — 全屏或区域捕获，JPEG压缩，供AI使用
- **窗口管理** — 列出、聚焦、最小化、最大化、调整大小、移动
- **浏览器** — 在默认浏览器中打开URL，支持多会话的完整Playwright自动化
- **笔记** — 保存、列出、读取、搜索、删除磁盘上的markdown笔记
- **剪贴板** — 通过PowerShell读取和写入
- **系统** — 运行shell命令、打开应用程序、等待
## 安装
```bash
git clone https://github.com/Nanonite-crypto/pc-control-mcp.git
cd pc-control-mcp
pip install -r requirements.txt
```
对于浏览器自动化功能，还需要安装Playwright浏览器：
```bash
playwright install chromium
```
## 运行
作为独立的MCP服务器（stdio传输）：
```bash
python server.py
```
## 连接到Claude Desktop
将以下内容添加到`%APPDATA%\Claude\claude_desktop_config.json`：
```json
{
"mcpServers": {
"pc-control": {
"command": "python",
"args": ["C:\\path\\to\\pc-control-mcp\\server.py"]
}
}
}
```
重启Claude Desktop。30多种工具将出现在MCP工具面板中。
## 技术细节
- Python 3.10+
- [FastMCP](https://github.com/jlowin/fastmcp) 作为服务器框架
- [pyautogui](https://pyautogui.readthedocs.io/) 用于输入自动化
- [pygetwindow](https://pypi.org/project/PyGetWindow/) 用于窗口控制
- [Playwright](https://playwright.dev/python/) 用于浏览器自动化
- Pillow 用于图像处理
## 安全说明
- `pyautogui.FAILSAFE = True` — 将鼠标移动到左上角以中止当前操作
- `run_command` 有30秒超时
- 笔记以纯markdown格式保存在服务器旁的`notes/`目录中
## 许可证
MIT
