Butterbase MCP 服务器深度指南：让 AI Agent 用 38 个工具直接操作你的后端

Butterbase MCP 服务器深度指南让 AI Agent 用 38 个工具直接操作你的后端【免费下载链接】butterbase-ossOpen-source backend-as-a-service. Postgres, auth, storage, functions, AI gateway, MCP.项目地址: https://gitcode.com/gh_mirrors/bu/butterbase-ossButterbase MCP 服务器butterbase/mcp是开源 BaaS 平台 Butterbase 的官方Model Context ProtocolMCP服务器。把它接入 Claude Code、Cursor、Windsurf 等任意支持 MCP 的 AI 客户端后你的 AI Agent 就能通过 38 个结构化工具直接管理后端创建应用、设计数据库表结构、配置认证、部署函数、管理存储与 RAG 知识库全程无需打开控制台。 什么是 Butterbase MCP 服务器AI 的后端遥控器MCPModel Context Protocol是连接 AI 助手与外部工具的标准协议。Butterbase 把整个控制平面Postgres 数据库、Auth、Storage、Serverless Functions、AI 网关、KV、实时通道等封装成一组 MCP 工具AI Agent 只需说人话下达任务服务器负责翻译成对控制 API 的精确调用。它的核心定位可以概括为三点全流程覆盖从init_app创建应用到迁移部署、区域迁移后端生命周期一站式托管给 AI零学习成本内置quickstart提示词和butterbase_docs本地文档工具AI 自己会读官方文档再动手安全边界清晰每个工具都标注了readOnlyHint/destructiveHint等 MCP 注解客户端可据此提示用户确认破坏性操作服务端实现入口在 services/mcp-server/src/create-server.ts38 个工具全部在这里注册标准输入输出stdio传输入口见 services/mcp-server/src/index.ts。⚡ 快速上手三种接入 Butterbase MCP 的方式方式一本地运行最通用在 MCP 客户端配置.mcp.json、claude_desktop_config.json等中加入以下条目用npx拉起服务器并把 API Key 通过环境变量注入{ mcpServers: { butterbase: { command: npx, args: [-y, butterbase/mcp], env: { BUTTERBASE_API_KEY: bb_sk_your_key_here } } } }完整配置说明可参考 services/mcp-server/README.md。方式二托管端点免本地安装Butterbase 同时提供托管的 MCP over HTTP 端点路径为/mcp只需在配置里声明url并带上Authorization: Bearer ${BUTTERBASE_API_KEY}请求头适合不想在本地装 Node 依赖的场景。方式三CLI 一键安装最省事Butterbase CLI 内置了 MCP 安装命令会自动探测本机所有 AI 客户端并批量写入配置然后打印每个客户端的一次性浏览器登录指引butterbase mcp这条命令的实现位于 packages/cli/src/commands/mcp.ts它会提示你在 Claude Code 里运行/mcp、在 Cursor 中点击 Needs Login、或在 VS Code 中通过 MCP: List Servers 触发 OAuth 认证。官方安装文档在 services/docs/src/content/docs/getting-started/mcp-setup.md。 38 个工具全解析AI 能对你的后端做什么工具源码分布在 services/mcp-server/src/tools/ 目录下每个文件注册一个组工具。按功能分组如下分类核心工具能做什么 应用管理init_app/manage_app/list_regions创建应用自动等待数据库 provisioned 完成、列出/删除/暂停应用、跨区域迁移️ 数据库manage_schema/manage_migrations/select_rows/insert_row/seed_database声明式建表支持 dry_run 预览、查历史迁移、增查数据、批量灌种子数据 认证与安全manage_auth_config/manage_auth_users/manage_oauth/manage_rls配置 JWT 时效、生成服务密钥、管理 OAuth 社交登录、开启行级安全策略⚙️ 函数与部署deploy_function/invoke_function/manage_function/manage_frontend/manage_edge_ssr/manage_preview/promote_preview部署并调试无服务器函数、发布静态前端、边缘 SSR、预览环境一键提升为正式 AI 与 RAGmanage_ai/manage_rag_content/rag_query配置 AI 模型网关、管理 RAG 知识库并让 AI 直接检索问答 存储与数据manage_storage/manage_kv/manage_people/manage_durable_objects文件存储桶、KV 键值对、联系人管理、Durable Objects 状态 运维可观测query_audit_logs/billing/api_keys/integrations查询审计日志、查看账单用量、管理 API 密钥与第三方集成细节文档见 services/docs/src/content/docs/api-reference/mcp-tools.md。几个值得新手注意的设计init_app会轮询等待创建应用后自动轮询状态直到数据库 ready最多约 60 秒AI 拿到的就是开箱即用的结果逻辑见 services/mcp-server/src/tools/init-app.tsbutterbase_docs是本地文档工具不发网络请求AI 遇到不会的操作会先查它支持按主题读取或自由文本搜索最相关章节services/mcp-server/src/tools/docs.tshackathon 工具动态出现submit_hackathon_entry只在比赛提交窗口期对 AI 可见窗口外自动从工具列表中隐藏 认证机制一次浏览器登录之后全托管Butterbase MCP 服务器支持两种认证方式API Keybb_sk_前缀写入客户端环境变量适合脚本化、CI 场景浏览器 OAuth交互式客户端推荐路径。第一次调用工具返回 401 时客户端会自动打开浏览器让你完成授权之后即可无感调用所有工具服务器在 MCPinitialize响应中自带instructions字段services/mcp-server/src/create-server.ts主动告诉 AI遇到 401 就引导用户去哪登录把新手最容易卡住的环节也交给模型自己处理。 实战让 AI 用 quickstart 提示词搭建完整后端安装完成后在 Claude Code / Cursor 里直接调用内置的quickstart提示词可传应用名它会输出一份标准 SOP创建应用 →manage_schema建表 →insert_row/seed_database写数据 →select_rows查询 → 开启 RLS → 部署函数 → 发布前端。你只需要用自然语言描述需求例如帮我建一个博客后端有文章和评论两张表开启用户隔离再部署一个前端静态页。AI 会按工具链自动执行全程你能看到每一步的输入输出。对于模板应用如 CRM、Support 桌面应用MCP 工具同样支持克隆与配置模板生态介绍见 templates/。 延伸学习源码与文档路径MCP 服务器主入口services/mcp-server/src/create-server.ts控制 API 调用层鉴权头转发、组织作用域services/mcp-server/src/api-client.tsCLI MCP 一键安装命令packages/cli/src/commands/mcp.tsMCP 安装官方文档services/docs/src/content/docs/getting-started/mcp-setup.md工具 API 参考services/docs/src/content/docs/api-reference/mcp-tools.md服务器发布元信息services/mcp-server/package.json✅ 常见问题Q38 个工具会不会太多AI 会选错吗工具描述description里都写明了用法示例、返回字段和常见错误MCP 注解还标注了只读/破坏性属性主流客户端会据此做确认拦截AI 误操作的概率很低。Q支持哪些客户端凡是支持 MCP 的客户端都可以Claude Code、Claude Desktop、Cursor、Windsurf、VS Code、JetBrains 系列等CLI 安装命令还会自动探测本机客户端。Q本地安装和托管端点怎么选追求稳定与免维护选托管端点需要离线调试或定制环境变量选本地npx方式两者工具集完全一致。一句话总结Butterbase MCP 服务器把操作后端控制台这件事从人工点击变成了 AI 对话——装好它你的 AI Agent 就获得了一套完整的后端操作权。【免费下载链接】butterbase-ossOpen-source backend-as-a-service. Postgres, auth, storage, functions, AI gateway, MCP.项目地址: https://gitcode.com/gh_mirrors/bu/butterbase-oss创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考