CloudBase-AI-Toolkit

让 AI 编码助手直接操作云开发数据库和函数

开源 freemium 开发框架

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1136

维护状态活跃

是否开源是

定价模式 freemium

项目预览

项目数据

分类开发框架

开发团队TencentCloudBase

所属国家

官网地址https://docs.cloudbase.net/ai/cloudbase-ai-toolkit

GitHubhttps://github.com/TencentCloudBase/CloudBase-AI-Toolkit

定价模式freemium

价格说明腾讯云CloudBase服务，基础免费额度，超出按量计费

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型agent-skills,ai,aicoding,claude-code,cloudbase,cursor,database,dsh-plugin,mcp,mcp-server,miniprogram,postgresql,supabase,tencent,vibe-coding,web

GitHub 星标★ 1136

30天Star增速

HF 下载量

上线时间2025-05-23 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-11

浏览次数0

项目介绍

CloudBase-AI-Toolkit 是腾讯云开发（CloudBase）团队开源的 AI 编程代理后端工具包，目标是让 Claude Code、Cursor 等 AI 编码助手能够直接操作云开发资源。它通过 Plugin、Skills 和 MCP（Model Context Protocol）三种方式，把数据库、身份认证、云函数等能力暴露给 AI 代理，使代理在写代码时能自动完成建表、查询数据、配置登录、部署函数等操作，而不只是生成代码片段。项目用 TypeScript 编写，同时兼容小程序、PostgreSQL、Supabase 等生态，适合需要把 AI 编码能力接入真实后端服务的开发场景。核心价值在于打通「AI 写代码」与「云端资源操作」之间的断层，减少手工配置和上下文切换。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

Node.js 环境（npx / npm 可用，用于拉取 MCP 与安装 CLI）
支持 MCP 的 AI 编码工具（如 Cursor、WindSurf、CodeBuddy）
网络可访问 npm registry（npx 会在线拉取 @cloudbase/cloudbase-mcp@latest）
腾讯云开发（CloudBase）环境，用于真正操作数据库、云函数等后端资源

安装与启动步骤

1选择接入方式

README 提供三种方式：Plugin 插件、CloudBase AI CLI、手动写 MCP 配置。按你的 IDE 是否支持插件来选择其一即可。
2插件方式安装

适用于支持插件机制的 AI 编码工具，一条命令把整套 CloudBase 能力装进 IDE。
```
npx plugins add TencentCloudBase/cloudbase-plugin
```
3安装 AI CLI

安装 CloudBase 命令行工具并进入 AI 模式，适合习惯终端操作的开发者。
```
npm i -g @cloudbase/cli && tcb ai
```
4配置 Cursor MCP

在项目下创建 .cursor/mcp.json，写入 mcpServers 配置，Cursor 启动时自动拉起 MCP 服务。
```
{
  "mcpServers": {
    "cloudbase": {
      "command": "npx",
      "args": ["@cloudbase/cloudbase-mcp@latest"]
    }
  }
}
```

5配置 WindSurf MCP

打开 .windsurf/settings.json，写入与 Cursor 相同的 mcpServers 配置即可。

{
  "mcpServers": {
    "cloudbase": {
      "command": "npx",
      "args": ["@cloudbase/cloudbase-mcp@latest"]
    }
  }
}

6CodeBuddy 免配置

CodeBuddy 已内置 MCP 与 Skills，通常无需手动写配置；也可从插件市场安装。

关键配置

配置项	必填	说明	示例
`mcpServers.cloudbase.command`	是	MCP 服务的启动命令，README 指定为 npx。	`npx`
`mcpServers.cloudbase.args`	是	传给 npx 的参数，指向 CloudBase MCP 包。	`["@cloudbase/cloudbase-mcp@latest"]`

如何确认成功

在 AI 工具里让代理执行一次 CloudBase 操作（如建表、查数据或部署云函数），能正常调用工具即接入成功。

常见问题

Q：Plugin 方式装不上或不被 IDE 支持怎么办？

A：改用另外两种方式：执行 npm i -g @cloudbase/cli && tcb ai，或直接在 IDE 配置文件里手写 mcpServers 的 MCP 配置。

Q：需要手动启动 MCP 服务吗？

A：不需要。配置里的 command 为 npx、args 指向 @cloudbase/cloudbase-mcp@latest，IDE 会按需自动拉起该服务。

Q：CodeBuddy 也要写 mcp.json 吗？

A：一般不用。README 说明 CodeBuddy 已内置 MCP 与 Skills，手动配置通常是多余的，也可从插件市场安装。

Q：其他 IDE 的配置示例在哪里看？

A：参考官方 IDE setup guide：https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/ ，README 只给出了 Cursor 与 WindSurf 的示例。

注意事项

README 中的 Quick start 章节为空，实际操作请以官方文档 docs.cloudbase.net 为准。
手动配置方式依赖在线拉取 @cloudbase/cloudbase-mcp@latest，网络不通时 IDE 内会无法启动 MCP。
README 提到 v2.35.x 起 MySQL 开通能力已从工具面移除，使用旧教程时注意版本差异。
配置文件中 mcpServers 的键名保持 cloudbase，避免工具调用时找不到服务。

核心亮点

同时提供 Plugin、Skills、MCP 三种接入方式，适配 Claude Code、Cursor 等不同 AI 编码工具
把数据库、认证、云函数等真实后端能力暴露给 AI 代理，而非只生成代码
背靠腾讯云开发生态，与小程序、PostgreSQL、Supabase 等场景衔接较自然

不足之处

与 CloudBase 平台绑定较深，脱离腾讯云开发后价值有限
项目较新，文档完整度和社区案例仍在积累中

适用场景

用 Claude Code 或 Cursor 开发小程序时，让 AI 自动建表、写查询并部署云函数
需要给 AI 编码助手接入真实数据库和登录认证的后端开发流程
团队希望用 MCP 统一管理 AI 代理对云端资源的访问权限

替代项目

Supabase MCP Server、Firebase Studio

上一篇：llama-agents

下一篇：mcts