CloudBase AI ToolKit

CloudBase AI Toolkit

ИИ пишет код. CloudBase запускает бэкенд.

Интеграционный слой CloudBase для инструментов ИИ-разработки: Plugin устанавливает стек, Skills направляют написание кода, MCP управляет базами данных, функциями и хранилищем, а также выполняет развертывание прямо из чата.

English · 简体中文 · Документация · История изменений · Проблемы

Последние обновления

v2.36.x (2026-10)

• MCP Apps: появились три панели — начало работы, использование среды и результат развертывания; они доступны в экспериментальном режиме и по умолчанию отключены. Чтобы попробовать, задайте CLOUDBASE_MCP_UI=on
• Безопасность: удаление, деструктивные SQL-запросы и соответствующие действия удаления callCloudApi приостанавливаются до подтверждения с указанием цели; для аргумента, похожего на учетные данные, выполняется одна проверка изменений (длина и отпечаток sha256, само значение не раскрывается)
• Среда: на панели использования появился раздел с метриками (QPS, вызовы, ошибки, тайм-ауты, нагрузка MySQL и CloudRun) и понятными названиями; подготовка MySQL больше не доступна через инструменты
• Начало работы: каждый ответ initialize содержит instructions с первым вызовом только для чтения; в документации по удаленной настройке теперь сначала описан OAuth

v2.35.x (2026-10)

• Хостинг / аутентификация: каждый запрос к размещенному MCP обрабатывается отдельным транспортом, а метаданные клиента кэшируются для каждого учетного ключа; учетные данные уровня проекта теперь имеют приоритет над состоянием входа в аккаунт
• Инструменты / Skills: подготовка MySQL больше не доступна через инструменты; каждый пакет skill содержит LICENSE.md рядом с SKILL.md; новый справочный skill по MCP описывает удаленные конечные точки, флаги плагина и схемы инструментов
• Обратная связь: prepareFeedback открывает страницу создания новой проблемы в репозитории вместо автоматически заполненного отчета об ошибке; размещенный сервер теперь включает тот же набор плагинов по умолчанию, что и локальный
• Начало работы / документация: каждый ответ initialize теперь содержит серверный instructions — первый вызов, порядок действий при первом запуске и подсказки, которые можно копировать без изменений; в документации по удаленной настройке теперь сначала описан OAuth: для настройки достаточно URL, а пара ключей предназначена для CI

v2.34.x (2026-09)

• i18n / IDE: полная локализация текстов инструментов с lang на уровне экземпляра, а также параметры auth site / region, чтобы вход на международном сайте и маршрутизация по регионам работали корректно
• Cloud API: список разрешенных сервисов callCloudApi расширен до 57, добавлено встроенное сопоставление версий (для сервисов с несколькими версиями, таких как tke / mongodb / vod, требуется явно указать version)
• Развертывание / среда: новый инструмент appBuild с нейтрализацией сборки для hosting; queryEnv сообщает фактически примененный регион, а domains учитывает переданный envId
• Skills / документация: при резервном чтении skills теперь используются официальный репозиторий распространения и список адресов справочных материалов; для cloudrun добавлен этап выбора базы данных с приоритетом SDK; ссылки на документацию сайта обновлены до актуальных Markdown-адресов; после развертывания в экспертных наборах и skills для развертывания предлагается поделиться результатом (по желанию, с удалением конфиденциальных данных, не более одного раза)
• Развертывание / приложения: канал загрузки в облако теперь работает от начала до конца (deployApp принимает возвращаемую временную метку getUploadUrl, а getBuildLog — идентификатор сборки, возвращаемый при развертывании); перед созданием маршрута шлюз проверяет наличие вышестоящего сервиса
• Skills / контекст: новый skill с рекомендациями по шаблонам доступа к PostgreSQL (пакетная обработка, индексы, разграничение ролей RLS, емкость для запуска); встроенные каталоги skills / OpenAPI в searchKnowledgeBase теперь загружаются по запросу, что сокращает поверхность из 43 инструментов на 9,1% при каждом tools/list
• Среда выполнения / хостинг: в режиме CloudRun Function нельзя привязывать PORT (это делает фреймворк функций); добавлен этап выбора учетных данных с указанием CLOUDBASE_APIKEY; пути и префиксы hosting нормализуются, поэтому начальный слеш больше не может интерпретироваться как пустой каталог
• Коннекторы: коннектор WorkBuddy для международного сайта (cloudbase-intl) создан на основе того же корпуса config/source/**, что и отечественный: удаленный streamableHttp со стандартным MCP OAuth вместо локального stdio, а хосты китайского сайта заменены на международные аналоги

Релизы · Поставить звезду · Следить → Релизы

Что это такое

ИИ-среды разработки (Cursor, Claude Code, Codex, CodeBuddy и другие) хорошо генерируют код. Обычно препятствием становится бэкенд: схемы, разрешения, функции, хранилище, среды и выпуск.

CloudBase — универсальный бэкенд Tencent Cloud с поддержкой ИИ (база данных, хранилище, аутентификация, облачные функции, Cloud Run и многое другое). Этот репозиторий — Toolkit, который подключает этот бэкенд к инструментам ИИ:

В этом репозитории публикуются npm-пакет @cloudbase/cloudbase-mcp, Skills и плагины для ИИ.

Вам по-прежнему нужна собственная среда CloudBase, а важные действия, предлагаемые ИИ, следует подтверждать. Toolkit предоставляет возможности и путь к их использованию, но не принимает решения за вас.

Связанные репозитории

Репозитории для публикации и синхронизации находятся в организации TencentCloudBase. Непосредственно с этим Toolkit связаны:

Для полного стека используйте Plugin; выбирайте только Skills, если нужны лишь ограничения и рекомендации. Для IDE с marketplace используйте этот репозиторий — не запускайте также npx plugins add для того же инструмента.

Быстрый старт

Самый быстрый способ начать

Скопируйте этот запрос для ИИ в свою IDE. Агент прочитает skill.md и выполнит настройку:

Set up CloudBase for me:
1. Open https://docs.cloudbase.net/skill.md and complete the setup following its instructions.
2. Tell me when you're done, and suggest the most relevant next step.

npx plugins add TencentCloudBase/cloudbase-plugin

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

Первые запросы

Login to CloudBase

Use CloudBase Skills to build a todo app with login, database and permissions, then deploy

Skills задают структуру и практики; MCP управляет средой и ресурсами. Вы должны иметь возможность проверять данные и API в собственной среде, а не только получать локальные исходные файлы.

Поддерживаемые IDE для ИИ

Полная настройка: руководства по IDE.

Возможности

После настройки ИИ сможет выполнять типичные задачи по работе с бэкендом в вашей среде (подтверждайте критически важные действия):

• База данных: PostgreSQL и документная БД, модели данных, CRUD, разрешения и правила безопасности
• Вычисления: создание, развертывание, вызов и отладка облачных функций / Cloud Run
• Аутентификация и хранилище: способы входа, объектное хранилище, связь разрешений с данными
• Выпуск и эксплуатация: статический hosting / публикация Mini Program; просмотр журналов и повторное развертывание

Подходит для Web, WeChat Mini Programs и серверных служб. Обзор платформы: документация CloudBase.

Оценка

В контролируемых условиях для сравнения двух вариантов бэкенда использовались одно и то же описание приложения Todo и один и тот же каркас фронтенда: традиционная облачная виртуальная машина (самостоятельное управление средой выполнения, процессом и сетевым доступом) и CloudBase (управляемая база данных, анонимная аутентификация и связанные службы бэкенда). ИИ-агент выполнил разработку и проверку от начала до конца. При заданных модели и настройке задачи вариант с CloudBase показал лучшие результаты по времени выполнения, расходу токенов и числу вызовов инструментов. Эти результаты зависят от модели, фреймворка агента и определения задачи, поэтому их не следует обобщать за пределами этих условий.

Методика, данные и ограничения: Оценка на одной задаче: облачная виртуальная машина и CloudBase

Установка и подключение

Предварительные требования

• Node.js v18.15.0+
• Среда CloudBase
• Инструмент ИИ с поддержкой Plugin / Skills / MCP

Варианты настройки

1. Плагин (если инструмент его поддерживает)
   npx plugins add TencentCloudBase/cloudbase-plugin
2. Ручная настройка MCP (запишите файл конфигурации IDE)

Уже используете CloudBase CLI? tcb ai также настроит MCP и Skills (документация).

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

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

Другие варианты: руководство по настройке IDE.

Режимы подключения MCP

Удалённый (рекомендуется): IDE подключается по HTTP к Tencent Cloud MCP. Node локально не нужен, а интерактивные клиенты завершают авторизацию в браузере.

Выберите конечную точку, соответствующую сайту, на котором находится ваша среда: у этих двух сайтов отдельные учётные записи, консоли и учётные данные.

OAuth (интерактивный, рекомендуется): URL — это вся конфигурация. IDE откроет браузер для входа и подтверждения доступа, а среду вы выберете там. Ключи не хранятся в файле конфигурации, и их не нужно менять.

{
  "mcpServers": {
    "cloudbase": {
      "type": "http",
      "url": "https://tcb-api.cloud.tencent.com/mcp/v1"
    }
  }
}

Статические учётные данные (для клиента без OAuth и для CI/CD): добавьте env_id и пару ключей, созданную на том же сайте, что и конечная точка.

{
  "mcpServers": {
    "cloudbase": {
      "type": "http",
      "url": "https://tcb-api.cloud.tencent.com/mcp/v1?env_id=<env_id>",
      "headers": {
        "X-TencentCloud-SecretId": "<Tencent Cloud Secret ID>",
        "X-TencentCloud-SecretKey": "<Tencent Cloud Secret Key>"
      }
    }
  }
}

Статическая пара ключей остаётся действительной, пока её не заменят или не удалят; сеанс OAuth завершается при выходе из системы. Используйте статический вариант только там, где браузерный сценарий невозможен, и не храните его в репозитории.

Локальный: запускает npx @cloudbase/cloudbase-mcp@latest на вашем компьютере — доступны все функции, включая загрузку из локальной файловой системы и скачивание шаблонов.

Компромисс удалённого режима: функции локальной файловой системы (загрузка и скачивание шаблонов) недоступны, а международный сайт пока не предоставляет инструменты NoSQL.

Удалённые URL также принимают site (domestic / intl; требуется только для среды на китайском сайте в ap-singapore, где регион неоднозначен), а также enable_plugins / disable_plugins для сокращения списка инструментов. Канонические имена указаны в mcp/src/server.ts.

Сквозное тестирование удалённого MCP (официальный клиент SDK): npm run test:hosted-mcp:e2e — режимы apikey/OAuth, staging с отключённой проверкой TLS и переменные среды описаны в tests/hosted-mcp-e2e/README.md. При отсутствии учётных данных тест пропускается (код выхода 0).

Самостоятельно размещённый Cloud Mode: задайте CLOUDBASE_MCP_CLOUD_MODE=true (или MCP_CLOUD_MODE=true), чтобы отключить инструменты локальных файлов и процессов для удалённых клиентов.

Пример

Онлайн-гомоку: опишите задачу; получите Web + облачную базу данных / realtime и разверните приложение.
Демо: Гомоку · Другие примеры: руководства

Документация

• Инструменты MCP (tools.json)
• Начало работы
• Настройка IDE
• Плагины ИИ
• Шаблоны
• Часто задаваемые вопросы

Часто задаваемые вопросы

{ "site": "domestic", "region": "ap-singapore", "envId": "your-env-id" }

Сообщество

Активность

Участники

MIT · TencentCloudBase