戳蜂鸣器代理
运行一个本地HTTP代理，注入您的Beeper身份验证令牌并保留 戳 隧道还活着，这样Poke特工就可以到达 蜂鸣器MCP 从任何地方。作为macOS launchd服务或Linux systemd用户服务运行，在登录时启动并在崩溃后幸存。
安装后，Beeper工具会自动出现在您的Poke代理中，无需手动设置MCP。
______________________________________________________________________
运作原理
Poke agent (internet)
|
poke tunnel
|
poke-beeper-proxy (localhost:23374)
— injects Bearer token on every request
|
Beeper Desktop MCP (localhost:23373)代理在本地运行并添加您的 BEEPER_TOKEN 每一个请求。poke隧道暴露了代理，因此您的poke代理可以从任何地方访问它。隧道连接后，Beeper工具在Poke中自动可用。
______________________________________________________________________
macOS设置
先决条件
- macOS --服务管理需要launchd
- Node.js 18+ --验证
node --version - poke命令行界面 —
npm install -g poke然后poke login - Beeper桌面 --启用MCP运行
NVM用户： NVM管理的节点路径在launchd内部可能无法正确解析。使用Homebrew节点(brew install node)以确保可靠的服务运行。
1.克隆并安装
git clone https://github.com/keith/poke-beeper-proxy
cd poke-beeper-proxy
npm install2.验证戳
poke login3.作为服务安装
npm run install-service脚本提示您 BEEPER_TOKEN，将其存储在macOS钥匙串中，写道 ~/Library/LaunchAgents/com.poke-beeper-proxy.plist，并立即启动服务。
获取啤酒\_ TOKEN
打开Beeper桌面→ 设置→ MCP.您的令牌列在那里。
4.验证
launchctl list com.poke-beeper-proxy # PID in first column = running
tail -f ~/Library/Logs/poke-beeper-proxy.log预期登录健康开始：
2026-02-17T18:00:00.123Z INFO [auth] BEEPER_TOKEN loaded from Keychain
2026-02-17T18:00:00.145Z INFO [main] poke-beeper-proxy starting up
2026-02-17T18:00:00.167Z INFO [tunnel] Starting poke tunnel → http://localhost:23374/v0/mcp (name: Beeper)
2026-02-17T18:00:00.189Z INFO [proxy] Listening on http://127.0.0.1:23374卸载（macOS）
npm run uninstall-service删除plist，卸载服务，并删除Keychain条目。
______________________________________________________________________
Linux安装程序
先决条件
- Node.js 18+ --通过您的包裹管理器或 非易失性存储器
- 系统守护进程 用户会话处于活动状态
- poke命令行界面 —
npm install -g poke然后poke login - Beeper桌面 --启用MCP运行
NVM用户： NVM垫片可能无法在systemd环境中解决。如果服务失败并显示“node:command not found”，请使用系统node.js安装。
1.克隆并安装
git clone https://github.com/keith/poke-beeper-proxy
cd poke-beeper-proxy
npm install2.验证戳
poke login3.作为服务安装
npm run install-service脚本提示您 BEEPER_TOKEN，将其存储在 ~/.config/poke-beeper-proxy/token （chmod 600），写入systemd用户单元文件，并启动服务。
4.验证
systemctl --user status poke-beeper-proxy
journalctl --user -u poke-beeper-proxy -f卸载（Linux）
npm run uninstall-service禁用和停止服务，删除单元文件，并删除令牌文件。
登录时运行（无头/无桌面会话）
默认情况下，systemd用户服务仅在您登录时运行。要在启动时启动，请执行以下操作：
loginctl enable-linger $USER______________________________________________________________________
开发模式
在前台运行，终端输出为彩色。阅读 BEEPER_TOKEN 从环境或 .env:
BEEPER_TOKEN=your_token npm start______________________________________________________________________
故障排除
服务未启动
macOS：
launchctl list com.poke-beeper-proxy # second column = exit code
cat ~/Library/Logs/poke-beeper-proxy.logLinux：
systemctl --user status poke-beeper-proxy
journalctl --user -u poke-beeper-proxy -n 50端口已在使用中
如果23374被占用，安装脚本会自动选择下一个空闲端口。要检查使用它的内容：
lsof -i :23374日志中“poke:找不到命令”
该服务需要修改其路径。
macOS： plist路径包括 /opt/homebrew/bin.重新安装以重新生成：
npm run uninstall-service && npm run install-serviceLinux： 编辑单位文件以添加您的戳位置：
systemctl --user edit poke-beeper-proxy添加到下面 [Service]:
Environment=PATH=/your/poke/bin:/usr/local/bin:/usr/bin:/bin然后： systemctl --user daemon-reload && systemctl --user restart poke-beeper-proxy
首次启动时的钥匙串对话框（macOS）
macOS可能会显示：“节点想要访问Keychain项目戳蜂鸣器代理”。点击 始终允许.
未找到BEEPER_TOKEN
macOS --验证钥匙链输入：
security find-generic-password -s poke-beeper-proxy -a beeper-tokenLinux --验证令牌文件：
ls -la ~/.config/poke-beeper-proxy/token # should show -rw-------
cat ~/.config/poke-beeper-proxy/token如果丢失，请重新安装：
npm run uninstall-service && npm run install-service工具未出现在Poke中
- 验证服务是否正在运行
- 检查日志是否存在同步错误
- 验证Beeper Desktop是否在启用MCP的情况下运行
- 验证您的令牌是否有效：
# macOS
curl -H "Authorization: Bearer $(security find-generic-password -s poke-beeper-proxy -a beeper-token -w)" http://localhost:23373/v1/accounts
# Linux
curl -H "Authorization: Bearer $(cat ~/.config/poke-beeper-proxy/token)" http://localhost:23373/v1/accounts有效令牌返回帐户数据；无效令牌返回401。
隧道不断重启
验证poke是否已登录：
cat ~/.config/poke/credentials.json如果丢失，请运行 poke login 然后重新启动：
# macOS
launchctl kickstart -k gui/$(id -u)/com.poke-beeper-proxy
# Linux
systemctl --user restart poke-beeper-proxy升级Node.js后
重新安装以更新嵌入式节点路径：
npm run uninstall-service && npm run install-service手动重新加载
macOS：
launchctl unload ~/Library/LaunchAgents/com.poke-beeper-proxy.plist
launchctl load -w ~/Library/LaunchAgents/com.poke-beeper-proxy.plistLinux：
systemctl --user daemon-reload
systemctl --user restart poke-beeper-proxy查看所有最近的日志（包括旋转日志）
macOS：
cat ~/Library/Logs/poke-beeper-proxy.log.1 ~/Library/Logs/poke-beeper-proxy.logLinux：
journalctl --user -u poke-beeper-proxy --since "1 hour ago"
# or from log file:
cat ~/.local/share/poke-beeper-proxy/poke-beeper-proxy.log