JosssphZhou/poki

项目介绍

Poki 是一个 MCP 服务器和可选终端代理，让 AI 代理通过 Mac 操作物理 iPhone。你可以接入已有的 MCP 客户端（Claude Code、Codex 或任何支持 mcpServers JSON 的客户端），也可以使用自带的 poki 代理，由代理读取屏幕并执行操作。项目声明不需要越狱或额外硬件，模拟器与物理设备通过原生桥接适配。

它面向已经在使用 LLM 代理、希望让代理操作 iOS 界面的开发者，例如在应用里搜索并总结结果。代理会记住历史任务，重复任务执行更快；配置好通道后还可以通过 iMessage 或 Telegram 使用。

快速使用

Mac 端需要 Apple Silicon、macOS 15 或更高版本、完整 Xcode、Rust、Node.js 24+ 和 ffmpeg。克隆仓库并运行安装脚本：

git clone https://github.com/JosssphZhou/poki.git
cd poki
./bin/setup
npm start

保持服务运行，在另一个终端、同一目录下注册 MCP 服务器：

claude mcp add --scope user poki-mcp -- node "$PWD/src/stdio.mjs"   # Claude Code
codex mcp add poki-mcp -- node "$PWD/src/stdio.mjs"                 # Codex

如果改用独立代理，在同一目录安装代理、把 bin 加入 PATH 并登录：

npm ci --prefix agent
export PATH="$PWD/bin:$PATH"
poki login
poki status

发布页还提供 poki-v0.1.0-macos-arm64.tar.gz 预编译包，包含原生桥接和 idevice 工具，因此不需要 Rust 和 ./bin/setup，但仍需 Xcode、Node.js 24+、Python 3 和 ffmpeg。物理 iPhone 需先用 USB 配对，并参考物理 iPhone 设置。随后查看设备并执行任务：

node bin/call.mjs list_devices
poki "Search esp32 in Chrome and summarize the top result"

多台设备时加 --device '<device UUID>'。其余选项见安装指南、工具参考和配置说明。

使用约束

• 平台：仅限 Apple Silicon 上的 macOS；徽章列出 macOS 和 iOS，其中 Mac 作为主机。
• 物理设备验证仅覆盖使用中文界面的 iPhone，且只支持竖屏；物理设备上不支持导出 App 容器和直接跳转设置子页面。
• 代理操控的是真实手机：要求发消息或付款时它会执行，屏幕内容会发送给配置的模型服务。
• 自动化第三方应用可能违反其服务条款，账号限制由使用者负责。软件按 AGPL-3.0-only 以现状提供。

HotRepo 点评

该项目在 2026-11-05 出现在 HotRepo 新项目榜，记录了约 2 小时 41 分钟（UTC 15:04 至 17:45）窗口内新增 108 Star、29 Fork。单次快照说明早期关注度上升很快，但时间序列太短，不能据此判断趋势，仓库也还没有 GitHub 日榜名次记录。更有价值的信号在范围：面向真实手机的 MCP 接口填补了多数编程向 MCP 工具不覆盖的空白，而对 macOS/Xcode 的依赖和较窄的物理设备验证范围，使它更接近开发者工具而不是通用消费应用。