SuperAPI AI 工具集

meetbot-mcp

Meet.bot 的 MCP(Model Context Protocol)服务器,让 AI 助手(如 Claude、ChatGPT 等支持 MCP 的工具)连接你的 Meet.bot 账户,检查真实日历可用时间并在 Google/Microsoft 日历上预订会议。按预订的会议收费,而非按席位收费。项目提供完整的 Meet.bot Booking Page API v1 覆盖、TypeScript 类型支持、Zod 运行时校验、Bearer Token 认证和详细错误处理,可本地(stdio)或远程(HTTP/SSE)运行,已部署于 https://mcp.meet.bot,采用 MIT 许可证。

访问官网

工具介绍

用途

Meet.bot MCP 是一个面向 Meet.bot Booking Page API 的 Model Context Protocol 服务器,用于把 AI 助手连接到 Meet.bot 账户,让 AI 代替用户安排会议。AI 可以检查真实日历可用性、查找时间段并直接通过 Meet.bot 账户完成预订,无需手动复制预订链接或查看日历。官方称其典型用例是希望自动化会议安排、让 AI 助手智能管理日历的忙碌专业人士。若尚无账户,可在 https://meet.bot 免费注册。

主要能力

  • 完整 API 覆盖:实现 Meet.bot Booking Page API v1 的全部端点。
  • 类型安全:完整 TypeScript 支持,提供全面的类型定义。
  • 运行时校验:使用 Zod schema 进行输入验证与数据完整性检查。
  • 认证支持:支持 Bearer Token 认证。
  • 错误处理:健壮的错误处理并返回详细错误信息。
  • 健康检查:通过 /v1/pages 端点进行内置健康监控。
  • MCP 协议合规:完整的 Model Context Protocol 服务器实现。
  • 双模式支持:可本地运行(stdio)或远程运行(HTTP/SSE)。
  • 生产部署:已在 https://mcp.meet.bot 上线,官方称经过充分测试与验证可用于生产。

服务器向 AI 助手暴露 8 个工具(官方在测试与校验部分另有一处表述为“全部 5 个工具”,两处数字不一致,此处按工具列表列出):

  • get_scheduling_pages:列出所有调度页面
  • get_page_info:获取页面详情
  • get_available_slots:查找可用时间段
  • book_meeting:预订会议
  • health_check:使用 /v1/pages 端点验证 API 连通性
  • list_webhooks:列出你的出站预订 webhook
  • set_webhook:创建或更新 webhook(booking_received / booking_rescheduled / booking_cancelled)
  • delete_webhook:删除 webhook

另外提供六个 MCP 提示(prompts/skills):schedule_meeting、check_availability、book_for_guest、share_booking_link、list_my_pages、suggest_times,并支持完整的 prompts/list 与 prompts/get。

Webhook 通知:会议被预订、改期或取消时即时通知。Meet.bot 会以 JWT 签名(HS256)的 JSON 载荷向你的 URL 推送每个事件,与合作伙伴 webhook 使用相同契约,事件包括 booking_received、booking_rescheduled、booking_cancelled。

使用方式

认证不是工具,而是基于连接的:

  • HTTP/SSE(远程,例如 https://mcp.meet.bot):连接时在请求头中发送 Authorization: Bearer <你的_api_token>。服务器在该会话的所有 API 调用中使用此 token。
  • Stdio(本地):启动服务器时设置 MEETBOT_AUTH_TOKEN 环境变量,例如 MEETBOT_AUTH_TOKEN=your_token npx @meetbot/mcp。 官方明确说明不存在 configure_meetbot 之类的配置工具;AI 直接使用上述工具,认证由连接处理。

基本流程:

  1. 将 Meet.bot API token 连接到 MCP 服务器。
  2. 配置 AI 助手使用此 MCP 服务器。
  3. 让 AI 助手安排会议——它可以检查可用性、查找时间段并直接通过 Meet.bot 账户预订。

部署选项:

  1. 本地模式(stdio 传输):用于与 Claude Desktop 等 AI 助手的本地集成,通过 stdio 通信。
  2. HTTP 模式(SSE 传输):用于远程部署。
  • SSE 端点:GET /sse,建立 MCP 通信的 SSE 连接
  • 消息端点:POST /messages?sessionId=<id>,接收客户端消息
  • 健康检查:GET /health,返回服务器健康状态
  • 所有请求都需要在 Authorization 头中携带 Bearer token,该 token 同时用于认证 Meet.bot API。

HTTP 服务器可部署到多种平台(以下为官方示例):Railway(railway up,已上线 https://mcp.meet.bot)、Fly.io(fly launch && fly deploy)、Google Cloud Run(基于容器部署)、AWS App Runner(基于容器部署)、任意 VPS(直接用 Node.js 运行)。项目包含示例 Dockerfile。

环境变量:可通过环境变量配置 MCP 服务器;认证基于连接而非工具:HTTP/SSE 在连接时发送 Authorization: Bearer <token>;Stdio 在运行服务器时设置 MEETBOT_AUTH_TOKEN(例如 MEETBOT_AUTH_TOKEN=your_token meetbot-mcp)。

包信息(官方给出):包大小 12.8 kB(解压后 58.0 kB)、21 个通过测试、3 个生产依赖、100% TypeScript 类型覆盖、构建状态通过、已发布到 npm registry。另提供命令行界面运行 MCP 服务器。

错误处理:针对常见问题提供详细错误消息,包括配置错误(缺失或无效配置参数)、认证错误(无效 token)、API 错误(来自 Meet.bot API 的详细错误消息)、校验错误(输入验证失败并指明具体字段错误)。

适用场景

适合希望让 AI 助手自动完成会议安排、检查日历可用时间段并直接预订会议的用户;支持通过远程 HTTP/SSE 部署共享,或本地 stdio 与桌面 AI 助手集成。

限制与说明

  • 必须拥有 Meet.bot 账户与 API token,认证通过连接(Bearer token 或 MEETBOT_AUTH_TOKEN 环境变量)完成,没有单独的配置工具。
  • 官方称按已预订会议收费,而非按席位收费;具体价格、套餐与免费额度暂未提供。
  • 基础 URL 已硬编码为 https://meet.bot,不再需要 baseUrl 配置(示例配置中已移除过时的 MEETBOT_BASE_URL)。
  • 工具数量在不同段落表述不一致(8 个与 5 个),本介绍按工具列表列出,实际以项目发布为准。
  • 采用 MIT 许可证。更多文档见 https://docs.meet.bot。