CloudBase AI ToolKit

CloudBase AI Toolkit

AI menulis kode. CloudBase menjalankan backend.

Lapisan integrasi CloudBase untuk alat coding AI: Plugin memasang stack, Skills mengarahkan cara kode ditulis, MCP mengelola database, fungsi, penyimpanan, dan deployment dari chat.

English · 简体中文 · Dokumentasi · Log perubahan · Masalah

Pembaruan terbaru

v2.37.x (2026-11)

• Diagnostik: error backend yang tidak transparan menjadi panduan langkah berikutnya; kegagalan CLS fungsi menyertakan RequestId dan dua jalur pemeriksaan mandiri paralel; pembaruan kode menyebutkan saat Status masih berjalan
• Keamanan / CloudRun: penghapusan massal gagal secara aman jika klien tidak dapat mengonfirmasi; jalur target CloudRun harus tetap berada di dalam proyek dan tidak boleh mengarah ke direktori kredensial host
• PostgreSQL: migrationVersion harus berupa stempel waktu kalender yang valid; migrationDetail hanya memerlukan versi; beberapa pemeriksaan jalur dan SQL yang menghasilkan positif palsu dilonggarkan
• Ekosistem: varian plugin Codex dalam format Agent Plugins; paket pasar skill Qianwen; paket konektor WorkBuddy untuk situs Tiongkok

v2.36.x (2026-10)

• MCP Apps: tiga panel — lingkungan, penggunaan lingkungan, dan hasil deployment — aktif secara default; atur CLOUDBASE_MCP_UI=off untuk menyembunyikannya
• Keamanan: penghapusan, SQL destruktif, dan tindakan penghapusan callCloudApi yang sesuai akan dijeda untuk meminta konfirmasi yang menyebutkan target; argumen berbentuk kredensial akan diperiksa perubahannya satu kali (panjang dan sidik jari sha256, bukan nilainya)
• Lingkungan: panel penggunaan kini memiliki tampilan metrik (QPS, pemanggilan, error, timeout, beban MySQL dan CloudRun) dengan nama yang mudah dipahami, dan penyediaan MySQL dihapus dari permukaan alat
• Orientasi: setiap respons initialize menyertakan instructions dengan panggilan hanya-baca pertama yang perlu dilakukan; dokumentasi penyiapan jarak jauh kini mengutamakan OAuth

Rilis · Beri bintang · Ikuti → Rilis

Apa itu

IDE AI (Cursor, Claude Code, Codex, CodeBuddy, dan lainnya) sangat andal dalam menghasilkan kode. Yang biasanya menghambat adalah backend: skema, izin, fungsi, penyimpanan, lingkungan, dan rilis.

CloudBase adalah backend lengkap native AI dari Tencent Cloud (database, penyimpanan, autentikasi, fungsi cloud, Cloud Run, dan lainnya). Repo ini adalah Toolkit yang menghubungkan backend tersebut ke alat AI:

Repositori ini menyediakan paket npm @cloudbase/cloudbase-mcp, Skills, dan plugin AI.

Anda tetap memerlukan lingkungan CloudBase sendiri, dan sebaiknya mengonfirmasi tindakan sensitif yang diusulkan AI. Toolkit menyediakan kemampuan dan jalur—bukan penilaian.

Repositori terkait

Repositori publikasi dan sinkronisasi berada di bawah TencentCloudBase. Repositori yang terkait langsung dengan Toolkit ini:

Pilih Plugin untuk stack lengkap; gunakan Skills saja jika Anda hanya memerlukan batasan pengetahuan. Untuk IDE marketplace, gunakan repo ini—jangan jalankan npx plugins add juga pada alat yang sama.

Mulai cepat

Cara tercepat untuk memulai

Salin prompt AI ini ke IDE AI Anda. Agen akan membaca skill.md dan menyelesaikan penyiapan:

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"]
    }
  }
}

Prompt pertama

Login to CloudBase

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

Skills membentuk struktur dan praktik; MCP menangani lingkungan dan sumber daya. Anda seharusnya dapat memverifikasi data dan API di lingkungan Anda sendiri—bukan hanya mendapatkan file sumber lokal.

IDE AI yang didukung

Penyiapan lengkap: Panduan IDE.

Kemampuan

Setelah penyiapan, AI dapat melakukan pekerjaan backend umum di lingkungan Anda (konfirmasikan langkah-langkah penting):

• Database: PostgreSQL dan document DB, model data, CRUD, izin, dan aturan keamanan
• Komputasi: menulis, men-deploy, memanggil, dan men-debug fungsi cloud / Cloud Run
• Autentikasi & penyimpanan: metode login, penyimpanan objek, keterkaitan izin dengan data
• Rilis & operasi: hosting statis / publikasi Mini Program; periksa log dan deploy ulang

Cocok untuk Web, WeChat Mini Programs, dan layanan backend. Ikhtisar platform: dokumentasi CloudBase.

Evaluasi

Dalam kondisi terkendali, ringkasan aplikasi Todo dan kerangka frontend yang sama digunakan untuk membandingkan dua jalur backend: VM cloud tradisional (runtime, proses, dan paparan jaringan dikelola sendiri) dan CloudBase (database terkelola, autentikasi anonim, serta layanan backend terkait). Agen AI melakukan pengembangan dan verifikasi menyeluruh. Dengan model dan penyiapan tugas tersebut, jalur CloudBase lebih unggul dalam latensi penyelesaian, penggunaan token, dan jumlah pemanggilan alat. Hasil ini bergantung pada model, kerangka kerja agen, dan definisi tugas, sehingga tidak boleh digeneralisasi di luar cakupan tersebut.

Metode, data, dan batasan: Evaluasi tugas yang sama: VM cloud vs CloudBase

Instal dan hubungkan

Prasyarat

• Node.js v18.15.0+
• Lingkungan CloudBase
• Alat AI yang mendukung Plugin / Skills / MCP

Opsi penyiapan

1. Plugin (jika alat mendukungnya)
   npx plugins add TencentCloudBase/cloudbase-plugin
2. MCP manual (tulis file konfigurasi IDE)

Sudah menggunakan CloudBase CLI? tcb ai juga menyiapkan MCP dan Skills (dokumentasi).

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

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

Lainnya: Panduan penyiapan IDE.

Mode koneksi MCP

Jarak jauh (disarankan): IDE Anda terhubung melalui HTTP ke Tencent Cloud MCP. Tidak memerlukan Node lokal, dan klien interaktif menyelesaikan otorisasi di browser.

Pilih endpoint yang sesuai dengan situs tempat lingkungan Anda berada—kedua situs menggunakan akun, konsol, dan kredensial yang terpisah.

OAuth (interaktif, disarankan): URL tersebut merupakan seluruh konfigurasi. IDE Anda membuka browser untuk login dan memberikan persetujuan, lalu Anda memilih lingkungan di sana—tidak ada kunci dalam file konfigurasi dan tidak ada yang perlu dirotasi.

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

Kredensial statis (untuk klien tanpa OAuth dan untuk CI/CD): tambahkan env_id dan pasangan kunci yang dibuat di situs yang sama dengan endpoint.

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

Pasangan kunci statis tetap valid hingga dirotasi atau dihapus; sesi OAuth berakhir saat Anda logout. Gunakan format statis hanya jika alur browser tidak memungkinkan—dan jangan simpan di repositori.

Lokal: menjalankan npx @cloudbase/cloudbase-mcp@latest di mesin Anda—fitur lengkap, termasuk unggah sistem file lokal dan unduh template.

Kompromi koneksi jarak jauh: fitur sistem file lokal (unggah, unduh template) tidak tersedia, dan situs internasional belum menyediakan alat NoSQL.

URL jarak jauh juga menerima site (domestic / intl, hanya diperlukan untuk lingkungan situs Tiongkok di ap-singapore, saat wilayahnya ambigu), serta enable_plugins / disable_plugins untuk membatasi alat. Nama kanonis tersedia di mcp/src/server.ts.

Remote MCP E2E (klien SDK resmi): npm run test:hosted-mcp:e2e — lihat tests/hosted-mcp-e2e/README.md untuk mode apikey/OAuth, staging TLS-insecure, dan env vars. Kredensial yang tidak tersedia akan melewati pengujian (exit 0).

Self-hosted Cloud Mode: atur CLOUDBASE_MCP_CLOUD_MODE=true (atau MCP_CLOUD_MODE=true) agar tool file dan proses lokal dinonaktifkan untuk pemanggil jarak jauh.

Contoh

Gomoku Online: jelaskan kebutuhan; dapatkan Web + database cloud / realtime, lalu deploy.
Demo: Gomoku · Lainnya: tutorials

Dokumentasi

• Tool MCP (tools.json)
• Memulai
• Penyiapan IDE
• Plugin AI
• Template
• FAQ

FAQ

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

Komunitas

Aktivitas

Kontributor

MIT · TencentCloudBase