内容
# 代码大全 CUA MCP
[中文版](README_CN.md)
💬 [LINUX DO Discussion](https://linux.do/t/topic/2490658)
一款封装了Codex的计算机使用能力的MCP服务器，使AI代理能够控制Windows桌面应用程序。
## 功能特点
- 列出和控制Windows桌面应用程序
- 捕获截图和可访问性树
- 点击、输入、按键、滚动、拖拽
- 启动应用程序并激活窗口
- **即用即行** - exe文件已打包，无需额外设置
## 快速开始（Claude Code）
```powershell
git clone <repo-url>
cd codex-cua-mcp
.\setup.ps1
```
重启Claude Code后即可使用。
## 其他代理
与任何MCP兼容的代理（Cursor、Windsurf、Cline等）配合使用：
```json
{
"mcpServers": {
"codex-cua": {
"command": "node",
"args": ["PATH/codex-cua-mcp/bin/codex-cua-mcp.js"]
}
}
}
```
请查阅您所使用的代理的文档以了解配置文件的位置。
## 工作原理
```
AI代理（Claude Code、Cursor等）
↓ MCP协议（stdio）
MCP服务器（codex-cua-mcp）
↓ JSON-RPC（stdin/stdout）
codex-computer-use.exe
↓ Windows API
桌面应用程序
```
MCP服务器通过JSON-RPC与`codex-computer-use.exe`通信，exe文件使用Windows API（SendInput、UI Automation、Windows.Graphics.Capture）与桌面应用程序交互。
每个操作在首次使用每个应用程序时都需要审批流程。服务器默认自动审批以实现无缝操作。
> 📖 想深入了解设计原理？请阅读[架构深度解析](docs/ARCHITECTURE.md)（[中文版](docs/ARCHITECTURE_CN.md)）。
## 可用工具
| 工具 | 描述 |
|------|-------------|
| `list_windows` | 列出所有可控窗口 |
| `list_apps` | 列出已安装的应用程序 |
| `get_window` | 重新获取窗口对象 |
| `launch_app` | 启动应用程序 |
| `activate_window` | 将窗口置于前台 |
| `get_window_state` | 捕获截图 + 可访问性树 |
| `click` | 在坐标或元素处点击 |
| `type_text` | 输入文本 |
| `press_key` | 按下键盘按键 |
| `scroll` | 滚动 |
| `drag` | 拖拽 |
| `set_value` | 设置可编辑元素的值 |
| `perform_secondary_action` | 次要操作（右键菜单等） |
## 免责声明
核心功能来自`codex-computer-use.exe`。实际结果取决于所使用的AI代理和模型 - 不保证可用性。
## 要求
- Windows 10/11
- Node.js 18+
## License
MIT
