Poki

项目简介

Poki 是开源的本地 MCP 服务器与代理，用于从 Mac 控制真实 iPhone。它通过原生触摸事件操作真实 iOS 应用与系统界面，无需越狱或额外硬件。通过核验的执行轨迹会编译为路线，使同类任务在重复执行时走更短路径。

核心功能

• Poki Agent 是带自学习路线的自主 iPhone 代理；Poki MCP 是用于控制 iPhone 的标准 MCP 服务器；通过核验的执行轨迹会编译为路线，使重复任务走更短路径；集成方式包括 Claude Code、Codex、iMessage 与 Terminal，Telegram 标注为即将推出；Poki 通过 Mac 以原生触摸事件控制真实 iPhone，无需越狱或外接硬件；Poki MCP 与 Poki Agent 以 AGPL-3.0 开源。

适用场景

• 从 iMessage 对话把购物清单加入提醒事项；操作真实 iOS 应用与系统界面，例如小红书收藏地点、地图路线与微信发送；读取支付宝账单、计算分类总计并把汇总写入备忘录；搜索携程车次选项，在付款前停止，并将所选车次加入日历。

快速开始

• 克隆仓库后运行 ./bin/setup，再用 npm start 启动服务器；为 Claude Code 使用 claude mcp add --scope user poki-mcp -- node "$PWD/src/stdio.mjs" 注册 MCP 服务器，或为 Codex 使用 codex mcp add poki-mcp -- node "$PWD/src/stdio.mjs"；使用 Poki Agent 时运行 npm ci --prefix agent，将 bin 目录加入 PATH，然后运行 poki login 与 poki

部署与要求

• 源码安装需要 macOS 15 或更高版本、完整 Xcode、Rust、Node.js 24+ 与 ffmpeg；预构建 macOS arm64 包需要 Apple Silicon macOS、完整 Xcode、Node.js 24+、Python 3 与 ffmpeg，不需要 Rust 与 ./bin/setup；物理 iPhone 需先通过 USB 与 Mac 配对。

采用前须知

• 许可证：AGPL-3.0。在使用、修改或分发项目前，请确认其具体条款。