AI导哈

Bubble MCP服务器

一个使AI助手能够通过Data API与Bubble.io应用程序交互的模型上下文协议服务器。

  • by D1DX
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 D1DX/bubble-mcp

使用说明

气泡MCP（D1DX叉）

模型上下文协议（MCP）服务器，使人工智能助手能够通过数据API与Bubble.io应用程序进行交互。

分叉自 dorianglz/bubble_mcp （原来 诺科德罗伊/泡泡_mcp).

我们修复了什么

上游仓库存在URL路径构造错误(诺科德罗伊/泡泡-mcp#5)这会导致MCP启动失败：

  • getSchema() 和 list() 前置 /api/1.1/ 到路径，但基本URL也可以包括 /api/1.1 --导致双路径请求(/api/1.1/api/1.1/meta)返回404。
  • get(), create(), update(), delete(), workflow() 使用相对路径，如 /obj/... 没有 /api/1.1/ --因此，它们仅在基本URL已经包含它时才起作用。
  • apiClient.ts 只接受 BUBBLE_API_URL，不 BUBBLE_BASE_URL （与README相矛盾）。

已应用修复程序

  1. apiClient.ts --接受两者 BUBBLE_API_URL 和 BUBBLE_BASE_URL.将任何输入标准化为始终以结尾 /api/1.1，而不管用户是否包括它。
  2. bubbleService.ts --所有路径现在都是相对的(/meta, /obj/..., /wf/...).没有方法前缀 /api/1.1/ 因为基本URL已经包括它。
  3. package.json --已添加 prepare 自动构建脚本 npx 安装。承诺 dist/ 零构建使用。

特性

  • 通用气泡支持：适用于任何Bubble.io应用程序
  • 自动发现：自动发现应用程序的数据类型和结构
  • CRUD操作：对所有数据类型执行创建、读取、更新和删除操作
  • 工作流执行：执行Bubble应用程序中定义的API工作流
  • 隐私设置感知：尊重Bubble的隐私规则和限制
  • 只读/读写模式：可配置的安全访问级别

快速开始

使用npx（无需本地安装）

{
  "mcpServers": {
    "bubble": {
      "command": "npx",
      "args": ["-y", "github:D1DX/bubble-mcp"],
      "env": {
        "BUBBLE_API_URL": "https://your-app.bubbleapps.io",
        "BUBBLE_API_TOKEN": "your-token",
        "MCP_MODE": "read-write"
      }
    }
  }
}

BUBBLE_API_URL 可以是 https://your-app.bubbleapps.io 或 https://your-app.bubbleapps.io/api/1.1 --两者都工作。

本地安装

git clone https://github.com/D1DX/bubble-mcp.git
cd bubble-mcp
npm install
npm run build

{
  "mcpServers": {
    "bubble": {
      "command": "node",
      "args": ["/path/to/bubble-mcp/dist/mcp-server.js"],
      "env": {
        "BUBBLE_API_URL": "https://your-app.bubbleapps.io",
        "BUBBLE_API_TOKEN": "your-token",
        "MCP_MODE": "read-write"
      }
    }
  }
}

环境变量

变量 必填 描述
BUBBLE_API_URL 是（或 BUBBLE_BASE_URL) 您的Bubble应用程序URL（有或没有 /api/1.1)
BUBBLE_API_TOKEN 是 气泡设置>API中的API令牌
MCP_MODE 没有 read-only （默认）或 read-write

可用工具

工具 描述 模式
bubble_get_schema 发现应用程序数据类型和结构 只读
bubble_list 列出数据类型的记录（带分页） 只读
bubble_get 按ID获取特定记录 只读
bubble_create 创建新记录 读写
bubble_update 更新现有记录 读写
bubble_delete 删除记录 读写
bubble_workflow 执行API工作流 读写

获取您的泡沫API代币

  1. 转到您的Bubble应用程序编辑器
  2. 导航到“设置”>“API”
  3. 启用“此应用程序公开数据API”
  4. 生成API令牌

许可证

麻省理工学院许可证--版权所有（c）2026 Daniel Rudaev@D1DX

学分

原始项目由 诺科德罗伊 和 多里昂兹.叉子由以下人员维护 D1DX.

相关 MCP