Campfire SMS

Campfire SMS MCP

给你的 Agent 发短信。 Campfire SMS 是一个托管式双向 SMS 桥接服务：当你的 Agent 需要答复或有结果时，它会给你发短信；你可以通过常用短信收件箱回复。

不要通过 pip install 安装此仓库，也不要在没有安装代码的情况下使用 npx 包名。请从 campfiresms.com 开始。

工作原理

• 你的 Agent 会建立桥接，并在需要输入或完成某件事时给你发短信。
• 你可以通过手机上的常用短信收件箱回复，无需安装手机应用。
• Agent 会取回你的回复，并使用自身的模型、工具和权限继续工作。Campfire SMS 负责手机注册、SMS 发送、经过身份验证的消息队列和路由。

Campfire SMS 并非为 Agent 提供一个供其他人发短信的电话号码。它会将你的 Agent 连接到运行它的你。

安装（通过 campfiresms.com）

1. 在 campfiresms.com 注册。
2. 验证你的手机号码。你会获得 40 条免费消息，无需提供银行卡。
3. 从你的账户复制一次性安装命令（Add computers → Add a computer or Bot → Create install command）。

完整说明：campfiresms.com/install.html

本地 Agent

适用于 Codex、Claude Code、Grok Build、OpenCode 或你电脑上的其他兼容 MCP 主机。运行账户中显示的命令：

npx -y @campfiresms/setup YOUR_INSTALLATION_CODE

• YOUR_INSTALLATION_CODE 来自你的账户。该命令只能使用一次，并会在 10 分钟后过期；如果已过期，请重新创建。
• 需要 Node.js 18+（含 npx）和 Python 3.12+。
• 安装程序会在本地保存安装凭据，并注册检测到的 Codex 和 Grok Build CLI。对于其他主机，请使用安装程序输出的命令，添加名为 campfire 的本地 MCP 服务。
• 在 Linux 或 VM 上，请使用与 Agent 相同的非 root 用户，在 Python 虚拟环境中运行安装程序。不要使用 sudo pip、系统 pip 或 --break-system-packages。请参阅 Linux/VM 说明。
• 保持电脑唤醒并联网，同时运行 Agent 会话。Campfire SMS 不会唤醒已停止的本地会话。

刷新已保存的本地连接：npx -y @campfiresms/setup update

托管式 MCP

Streamable HTTP 端点：

https://api.campfiresms.com/mcp

它需要从你的账户获取每个安装专用的 bearer 凭据，并通过 Authorization: Bearer <credential> 发送。没有该凭据就无法使用：仅添加 URL（例如，通过目录的一键安装）会得到 HTTP 401。

若要获取凭据，请运行账户中的安装命令并附加 --credential-only（需要 Node.js 18+，不需要 Python 或 pip）。请仅将凭据填入客户端的安全凭据设置中。

Grok Bot 云端例程示例：使用该凭据连接托管式 MCP，然后设置一个启用的 webhook 例程，并将其 URL 和密钥保存到账户中的 Grok Bot 24/7 wake。这样，收到短信后即可在电脑关闭时启动例程。请参阅 Grok Bot 操作指南。

工具

工具	用途
campfire_open_bridge	打开（或复用）到已验证手机的 SMS 桥接
campfire_send_message	给你发送短信
campfire_check_messages	获取待处理的回复（在确认前会重复返回）
campfire_ack	处理完毕后确认消息 ID
campfire_close_bridge	会话结束后关闭桥接

限制与安全

• SMS 回复不会赋予 Agent 新权限。它们可以在 Agent 现有权限范围内引导工作；原生审批仍由 Agent 处理。
• SMS 并非端到端加密。请勿通过短信发送密码、凭据、付款信息或其他机密。
• 每条发送或接收的短信都计为一条消息。消息用完后，短信服务会暂停。请参阅定价。

链接

• 网站：https://campfiresms.com
• 安装指南：https://campfiresms.com/install.html
• 支持：[email protected]

关于此代码库

此代码库包含较早版本 v0.1.1 Python 连接器的源代码，供参考。当前的 @campfiresms/setup 安装程序已捆绑维护中的连接器。全新安装时，请按照上面的步骤操作，而不要使用此源代码。