Blooio

Blooio MCP 服务

一个面向 Blooio v4 API 的 Model Context Protocol 服务。它让 Claude、ChatGPT、Cursor 及其他任何 MCP 客户端能够发送和接收 iMessage、SMS、RCS 和 WhatsApp 消息，并管理频道、号码、联系人、聊天、群组、通话、10DLC 注册、支持工单、webhook 和事件流。

这是一个轻量封装：每个工具都使用连接者的凭据调用一次 Blooio API。

连接

将此服务 URL 添加到 MCP 客户端：

https://mcp.blooio.com/v4

客户端会打开一个浏览器窗口，你可以在其中登录 Blooio、选择要连接的组织并批准权限。访问令牌会自动刷新；你可以随时在组织的已安装应用中撤销访问权限。

如果客户端不支持 OAuth，请改用 Blooio API 密钥：

Authorization: Bearer bl_live_...

工具

每个 v4 API 操作都对应一个工具，这些工具根据已发布的 OpenAPI 规范生成，因此工具集始终与文档保持一致。工具参数包括操作的：

• 路径参数，采用 snake_case 格式（/chats/{chatId} 使用 chat_id）
• 查询参数
• 请求体字段，平铺到顶层
• idempotencyKey，适用于接受 Idempotency-Key 标头的操作

上传文件的操作（set_group_icon、set_chat_background、upload_contact_card_avatar）接受公开 URL；服务会下载文件并上传到 Blooio。

调用失败时，API 错误会作为工具结果返回，以便模型读取并修正调用。

此外还提供资源（blooio://account/info、blooio://channels、blooio://webhooks）和一些入门提示词（send_quick_message、check_delivery、send_with_attachment、verify_contact、setup_webhook、start_group_chat）。

登录方式

此服务是面向 MCP 客户端的 OAuth 2.1 授权服务器，支持动态客户端注册、使用 PKCE（S256）的授权码和刷新令牌。实际登录由 Blooio 的 OAuth 完成：

1. MCP 客户端在 /oauth/register 注册，并打开 /oauth/authorize。
2. 确认页面会显示客户端名称和重定向目标，随后跳转到以 Blooio MCP 应用身份呈现的 Blooio 授权页面。
3. Blooio 重定向回 /oauth/callback。如果用户在多个组织中安装了该应用，服务会询问此连接应使用哪个组织。
4. 客户端收到与所选组织绑定的 Blooio 令牌（bmcp_<organization_id>.<token>），因此每次工具调用都会固定到该组织。服务不会存储长期令牌；刷新请求会转发给 Blooio。

发现文档位于 /.well-known/oauth-authorization-server 和 /.well-known/oauth-protected-resource。没有有效凭据的调用会收到带有指向后者的 WWW-Authenticate 标头的 401 响应。

端点

端点	用途
POST /v4	MCP JSON-RPC（Streamable HTTP，JSON 响应）
GET /v4/manifest	以 JSON 格式返回工具、资源和提示词
POST /v4/call	不使用 JSON-RPC 封装的单次工具调用：{ "tool": "...", "arguments": {...} }
ALL /v4/<path>	转发到 https://api.blooio.com/v4/<path>
/oauth/*、/.well-known/*	OAuth 和发现

开发

需要 Node 22+。

npm install
npm test            # unit tests
npm start           # wrangler dev on http://localhost:8787

要在本地运行登录流程，请在控制面板中创建 Blooio 应用（Developers → Apps），将重定向 URI 设为 http://localhost:8787/oauth/callback，将客户端 ID 填入 wrangler.toml 中的 BLOOIO_OAUTH_CLIENT_ID，并将密钥填入 .dev.vars：

BLOOIO_OAUTH_CLIENT_SECRET=blosec_...

然后将 MCP Inspector 指向 http://localhost:8787/v4。

更新工具

src/operations.json 根据 OpenAPI 规范编译生成。要重新生成它：

npm run sync-spec -- https://docs.blooio.com/openapi.v4.json

许可证

Apache 2.0