Blujay

Blujay MCP 服务

让 Claude、Cursor、VS Code 和其他 AI 助手使用你的 Blujay 账号：读取对话、查看哪些人需要回复，并通过你的 Blujay 电话号码发送 iMessage、RCS 和 SMS。

每条短信都是真实发送。 Blujay 没有测试模式。除非你已将助手设置为自动批准工具，否则大多数助手每次发送前都会征求你的同意。因此，建议先使用 --allow-send-to 将发送对象限制为你自己的号码（参见安全）。

你可以询问

• “今天谁给我发了短信，而我还没回复？”
• “总结我和 Ava 的对话，并起草一条回复。”
• “给 +1 555 555 0123 发短信：我会晚到 10 分钟。”
• “把我桌面上名为 beach.jpg 的照片发给 Ava。”
• “把 Downloads 文件夹里的租约 PDF 发给 Sam。”
• “给 Ava 发送生日快乐，并附上气球。”
• “我上次发给 Sam 的消息送达了吗？”
• “为 Ava 启动 Website demo texts 工作流。”
• “这个号码支持 iMessage 吗？”
• “设置一个 webhook，将新消息发送到 https://example.com/blujay。”
• “如何验证 webhook 签名？”

设置

你需要 Node.js 20 或更高版本，以及 Blujay 中 API 选项卡里的 Blujay API 密钥。

这些按钮会使用占位密钥添加服务；请将 blu_your_api_key 替换为你自己的密钥。

Claude Desktop

打开 Settings → Developer → Edit Config 并添加：

{
  "mcpServers": {
    "blujay": {
      "command": "npx",
      "args": ["-y", "blujay-mcp"],
      "env": { "BLUJAY_API_KEY": "blu_your_api_key" }
    }
  }
}

重启 Claude Desktop。

Claude Code

claude mcp add blujay --env BLUJAY_API_KEY=blu_your_api_key -- npx -y blujay-mcp

Cursor

在 Cursor Settings → Tools & MCP → New MCP Server 中，将以下内容添加到 mcp.json：

{
  "mcpServers": {
    "blujay": {
      "command": "npx",
      "args": ["-y", "blujay-mcp"],
      "env": { "BLUJAY_API_KEY": "blu_your_api_key" }
    }
  }
}

VS Code

将以下内容添加到项目中的 .vscode/mcp.json：

{
  "servers": {
    "blujay": {
      "command": "npx",
      "args": ["-y", "blujay-mcp"],
      "env": { "BLUJAY_API_KEY": "${input:blujay-api-key}" }
    }
  },
  "inputs": [
    { "id": "blujay-api-key", "type": "promptString", "description": "Blujay API key", "password": true }
  ]
}

其他 MCP 客户端

设置 BLUJAY_API_KEY 后运行 npx -y blujay-mcp。它通过 stdio 使用 MCP 协议通信。

安全

• 助手会在发送前征求同意。 每个工具都会标记为读取或操作，因此你的客户端可以批准读取，并在任何内容发送给他人之前征求同意。
• --allow-send-to +15555550123 会将所有发送和更改操作限制为你列出的号码；请先用你自己的号码试用。
• --read-only 会移除所有用于发送、更改或删除的工具。
• 文件只能通过完整路径指定： 照片、视频、文档、联系人卡片和音频文件，大小不超过 100 MiB，并会根据文件内容进行检查。

有关详情，包括这些检查无法防止的情况，请参阅 SECURITY.md。

工具

工具	功能	会联系某人
get_account	查看你的工作区、电话号码及各号码的功能
list_conversations	查看最近的对话，可按某个人或某个号码筛选
get_conversation	按电话号码、电子邮件或聊天 ID 查找对话记录
find_unanswered	查找正在等你回复的对话
get_message	查看消息的送达状态及失败原因
check_imessage	检查某个号码是否使用 iMessage
find_contacts	按姓名、电话号码或电子邮件搜索联系人，或列出已保存（或未保存）的联系人
list_workflows	查看可为联系人启动的工作流（处于活动状态、已发布且由手动启动；由标签触发的工作流会通过 save_contact 启动）
list_webhooks	查看 Webhook 订阅及近期投递尝试
search_docs	搜索 docs.blujay.io
send_message	向某人或群组发送短信，或在对话中回复；可附带电脑中的照片、视频、文档、联系人名片或音频文件（作为语音备忘录发送），也可附带链接中的照片、视频或联系人名片，或在后续消息中添加气球、重击等 iMessage 特效	是
react_to_message	添加或移除 Tapback 或表情符号回应	是
edit_message	编辑已发送的 iMessage	是
unsend_message	撤回已发送的 iMessage	是
mark_conversation_read	将对话标记为已读	是（已读回执）
set_typing	显示或隐藏正在输入提示气泡	是
update_group	重命名 iMessage 群组，或添加、移除成员	是
save_contact	创建或更新联系人，并为其添加标签	可以：标签可启动会给联系人发送短信的工作流
enroll_in_workflow	为联系人启动手动工作流；可安全重试，同一请求绝不会重复加入	是：工作流会给联系人发送短信
opt_out_contact	停止向联系人发送所有短信（使用 --allow-send-to 可关闭）
create_webhook	创建 Webhook 订阅（使用 --allow-send-to 可关闭）
invoke_api	调用任意 Blujay 端点（仅在使用 --enable-invoke-api 时可用）	视情况而定

提示词

MCP 客户端会将以下内容显示为预设操作：

• 谁需要回复？ 查找正在等你回复的对话，并为每个对话起草回复，但不会发送。
• 总结与某人的对话。
• 给我发送测试消息到你自己的手机，并确认已送达。

选项

选项	效果
--read-only	仅启用读取工具
--allow-send-to <numbers>	仅联系这些以逗号分隔的号码
--enable-invoke-api	添加可调用任意端点的 invoke_api。与 --read-only 或 --allow-send-to 一起使用时，仅支持 GET
--help、--version

故障排除

• “set BLUJAY_API_KEY”：将密钥添加到 MCP 客户端配置的 env 块中，然后重启客户端。
• 401、API_KEY_REVOKED 或 API_KEY_EXPIRED：发送电子邮件至 [email protected] 获取新密钥，然后更新 BLUJAY_API_KEY。
• 未显示工具：检查终端中的 npx -y blujay-mcp --version 是否能正常运行，然后重启 MCP 客户端。

更多信息

• Blujay API 文档
• 为你自己的代码提供的库：blujay on npm 和 blujay on PyPI
• 问题和 Bug：[email protected] 或提交 issue。安全问题：SECURITY.md

许可证

MIT