58 下载次数
公开版本 1.1.0 · macOS 13+ · Apple Silicon 与 Intel
安装并打开 pika,然后使用下方命令连接。 新功能:扫描二维码,在手机上查看 Mac 状态。 查看源代码 ↗
/Applications/pika.app/Contents/MacOS/pika-mcp
Set up once on the same Mac. Your agent can then read status and control Session / Monitor.
Install the pika PKG, which includes the app and helper. Open pika from Applications and keep it running in the menu bar. Installation help ↗
If Codex CLI is installed, paste this into Terminal once. The MCP client starts the server when it connects.
codex mcp add pika -- /Applications/pika.app/Contents/MacOS/pika-mcp
For Codex, add this section to ~/.codex/config.toml. If pika already exists, update it instead of adding a duplicate. Keep your other settings.
[mcp_servers.pika] command = "/Applications/pika.app/Contents/MacOS/pika-mcp"
Add a server named pika using STDIO. Set Command to the path below. Leave arguments and environment variables empty. No server URL or API key is required.
This is a local STDIO connection. The website address is not an MCP endpoint, and a cloud-only URL connector cannot run this Mac executable.
Save, restart your MCP client, and open a new chat. Ask your agent:
Call pika_status and show the current state. Do not change Session or Monitor.
A successful pika_status tool result confirms the connection to the app. Session OFF is normal; helper registration alone does not confirm helper connectivity.
pika_set_session — Session ON / OFFpika_set_monitor — Monitor ON / OFF · requires Session ON
pika_set_session
pika_set_monitor
Session ON prepares pika. Display policy applies only after the lid closes. With the lid open, Monitor changes only save your preference.
Closing the agent does not end a pika session. Turn Session OFF in pika or ask your agent to do so.
After updating, restart your MCP connection and ask: Create a pika QR. pika_remote_pair returns a text QR plus a PNG and HTML fallback. Scan with your phone camera and tap Connect. The QR is single-use and expires in 5 minutes; read-only access lasts up to 24 hours. It does not start Session. Revoke with pika_remote_revoke or the Mac menu. Never share the QR.
No tools: confirm the command path and restart the client. App connection error: open pika on the same Mac and user account. Helper error: quit pika, reinstall the latest full PKG, and reopen pika. If Terminal says codex was not found, use the configuration-file option above.