TencentCloudBase/CloudBase-AI-Toolkit

Backend for AI coding agents on CloudBase — database, auth, functions via Plugin, Skills & MCP.

CloudBase AI Toolkit – 빠른 개요

정의: AI 기반 코딩 어시스턴트(예: Claude Code, Cursor, GitHub Copilot)가 Tencent CloudBase(데이터베이스, 스토리지, 인증, 클라우드 함수, 정적 사이트 호스팅을 제공하는 관리형 BaaS)와 직접 통신할 수 있게 하는 오픈소스 통합 레이어입니다. 이 툴킷은 세 부분으로 구성됩니다:

구성 요소	역할	사용 방법
플러그인	MCP 서버를 설치하고, Agent Skills을 등록하며, IDE를 연결하여 AI가 맞춤 연결 없이 백엔드 작업을 호출할 수 있게 합니다.	`npx plugins add TencentCloudBase/cloudbase-plugin` (또는 각 IDE의 마켓플레이스 통해).
Agent Skills	PostgreSQL 테이블 생성, 인증 설정, 함수 배포 등의 일반적인 CloudBase 작업을 설명하는 사전 작성된 "스킬" 정의로, AI가 구조화된 도구 호출로 호출할 수 있습니다.	`npx skills add TencentCloudBase/cloudbase-skills --skill <이름>`
MCP (Mobile Cloud Platform) 서버	AI 에이전트가 통신하는 경량 JSON-RPC 스타일 서비스: 로그인, 데이터 쿼리/변경, 함수 관리, 로그 읽기, 배포 트리거.	`npx @cloudbase/cloudbase-mcp@latest`로 로컬 실행 또는 HTTP/OAuth로 원격 연결.

대상 사용자

웹 앱, WeChat 미니 프로그램 또는 기타 서비스의 백엔드 코드를 AI 어시스턴트가 작성하도록 하면서 실제 리소스는 Tencent Cloud에 유지하려는 개발자.
이미 CloudBase를 사용하고 있으며, AI가 반복적인 클라우드 리소스 작업을 처리하여 프로토타이핑, CI/CD, 온보딩을 가속화하려는 팀.

주요 기능 (AI에 노출)

데이터베이스 – PostgreSQL 또는 문서 DB 스키마 생성/수정, CRUD 작업 실행, 권한 설정.
컴퓨팅 – 클라우드 함수 또는 Cloud Run 서비스 작성, 배포, 호출, 디버깅.
인증 및 스토리지 – 로그인 방법 구성, 객체 스토리지 버킷 관리, 스토리지 권한을 데이터 규칙에 연결.
릴리스 및 운영 – 정적 사이트 호스팅, 미니 프로그램 게시, 로그 검사, 재배포.

시작하기 (가장 빠른 방법)

아래 프롬프트를 AI 지원 IDE에 복사합니다:

CloudBase를 설정해 주세요:
1. https://docs.cloudbase.net/skill.md를 열고 지침에 따라 설정을 완료하세요.
2. 완료되면 알려주시고, 가장 관련성 높은 다음 단계를 제안해 주세요.

도구에 맞는 설정 방법(플러그인, CLI 또는 원시 MCP 설정)을 선택합니다. 일반 IDE의 예:

{
  "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.

지원되는 AI IDE (2026년 10월 기준)

이 툴킷은 Cursor, Claude Code, Codex, CodeBuddy, WorkBuddy, Doubao, MiniMax Code, DeepSeek Harness, ZCode, Kimi, GitHub Copilot 등 수십 개의 AI 코딩 환경용 기성 커넥터를 제공합니다. 각 IDE에는 README에 짧은 가이드가 링크되어 있습니다.

설치 옵션

모드	사용 시기	명령/설정
플러그인 (IDE 네이티브)	IDE가 Open Plugin Spec을 지원하는 경우.	`npx plugins add TencentCloudBase/cloudbase-plugin`
CloudBase AI CLI	여러 IDE에서 작동하는 단일 CLI.	`npm i -g @cloudbase/cli && tcb ai`
MCP 전용	최소 설정 – JSON-RPC 서버만.	`npx @cloudbase/cloudbase-mcp@latest` (로컬) 또는 리모트 HTTP 엔드포인트(OAuth/정적 키, README 참조).

원격 MCP는 다음에서 액세스할 수 있습니다:

중국 사이트: https://tcb-api.cloud.tencent.com/mcp/v1
국제 사이트: https://tcb-api.tencentcloud.com/mcp/v1

예제 프로젝트

리포지토리에는 CloudBase 실시간 데이터베이스를 사용하고 단일 AI 프롬프트로 배포되는 온라인 오목 게임이 소개되어 있습니다. 데모 URL: https://cloud1-5g39elugeec5ba0f-1300855855.tcloudbaseapp.com/gobang/#/

문서 및 추가 정보

MCP 도구 정의: doc/mcp-tools.md
전체 시작 가이드: https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/getting-started
FAQ (Vercel/Netlify 비교 포함) 및 AI 기반 CloudBase 개발의 성능 평가.

위의 모든 세부 사항은 리포지토리의 README에서 직접 가져온 것입니다. 추가 기능은 추론되지 않습니다.