🌟 CloudBase AI ToolKit

Such as Cursor | WindSurf | CodeBuddy etc. Click to see list of supported AI development tools

Visit Tencent CloudBase Console to create an environment. New users can start for free.

Make sure Node.js v18 or higher is installed on your computer. You can download and install the latest version from Node.js official website.

To improve dependency download speed, it's recommended to set npm registry to Tencent mirror. You can run the following command in terminal:

npm config set registry https://mirrors.cloud.tencent.com/npm/

This speeds up dependency downloads, especially in mainland China.

Run the following command in terminal:

npx -y clear-npx-cache 

Template includes .cursor/rules/ directory, AI will automatically recognize CloudBase best practices. If not starting from template, you can ask AI to help download CloudBase rules.

If using template project, MCP configuration is pre-configured. Please click the popup window at the bottom left to enable MCP. If not starting from template, click the button below to install in Cursor:

Or manually add configuration to .cursor/mcp.json:

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

Then click the ⚙️ icon in the top-right corner of Cursor client, go to "MCP" settings, find cloudbase and enable it.

Use Agent mode in the chat window for code generation and automation.

Template's .windsurf/ directory contains configurations optimized for WindSurf. If not starting from template, you can ask AI to help download CloudBase rules.

If using template project, MCP configuration is pre-configured. If not starting from template, add in WindSurf's Plugins configuration:

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

Switch to Write mode in chat for intelligent generation.

Template includes .rules/ directory, CodeBuddy will automatically recognize CloudBase best practices. If not starting from template, you can ask AI to help download CloudBase rules.

1. You can click the MCP button in the top-right corner of CodeBuddy, search for CloudBase in the MCP marketplace, and click install.

2. Or manually add: click the MCP button in the top-right corner of CodeBuddy, click add on the right, and add CloudBase MCP in the MCP configuration:

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

Switch to Craft mode in the chat window. It's recommended to disable the confirm plan feature in the right settings for a smoother experience.

Template includes .clinerules/ directory, AI will automatically recognize CloudBase best practices. If not starting from template, you can ask AI to help download CloudBase rules.

If using template project, MCP configuration is pre-configured. If not starting from template, add in MCP Server configuration:

{
  "mcpServers": {
    "cloudbase": {
      "autoApprove": [],
      "timeout": 60,
      "command": "npx",
      "args": [
        "@cloudbase/cloudbase-mcp@latest"
      ],
      "transportType": "stdio",
      "disabled": false
    }
  }
}

It's recommended to use models that support code generation and function calls.

Template's .github/ directory contains Copilot optimized configurations. If not starting from template, you can ask AI to help download CloudBase rules.

If using template project, MCP configuration is pre-configured. If not starting from template, add in .vscode/mcp.json:

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

Switch to Agent mode in the bottom-left corner of the chat window.

This guide supports both Trae international and Trae CN versions. It's recommended to test with Claude/DeepSeek V3 0324 models.

Template's .trae/rules directory contains CloudBase rule configurations for Trae. If not starting from template, you can ask AI to help download CloudBase rules.

Add in Trae's MCP configuration:

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

Select Builder with MCP in the agent for chat.

Template includes .lingma/ directory, Tongyi Lingma will automatically recognize CloudBase best practices. If not starting from template, you can ask AI to help download CloudBase rules.

If using template project, MCP configuration is pre-configured. If not starting from template, add in MCP configuration:

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

Switch to agent mode in the bottom-left corner of the chat window.

Template includes .roo/rules directory, RooCode will automatically recognize CloudBase best practices. If not starting from template, you can ask AI to help download CloudBase rules.

If using template project, MCP configuration is pre-configured. If not starting from template, add in MCP configuration:

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

Use the chat window for code generation and automation.

Template includes .comate/rules directory, Baidu Comate will automatically recognize CloudBase best practices. If not starting from template, you can ask AI to help download CloudBase rules.

If using template project, MCP configuration is pre-configured. If not starting from template, add in MCP configuration:

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

Use Agent mode in the chat window for intelligent code generation and automation.

Template includes .augment-guidelines file, Augment Code will automatically recognize CloudBase best practices. If not starting from template, you can ask AI to help download CloudBase rules.

If using template project, MCP configuration is pre-configured (built into .vscode/settings.json). If not starting from template, add CloudBase MCP in Augment's MCP configuration, refer to documentation:

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

Use Agent mode in the chat window for intelligent code generation and automation.

Template includes CLAUDE.md file, Claude Code will automatically recognize CloudBase best practices. If not starting from template, you can ask AI to help download CloudBase rules.

If using template project, MCP configuration is pre-configured. If not starting from template, create .mcp.json file in project root:

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

Chat directly with AI in Claude Code for intelligent code generation and automation.

Make sure Node.js 18+ is installed, then install Gemini CLI globally:

npm install -g @google/gemini-cli

Or run directly:

npx @google/gemini-cli

On first run, log in with your personal Google account to get free quota (60 requests per minute, 1000 requests per day).

If using template project, MCP configuration is pre-configured.

If not starting from template, create .gemini/settings.json file in user home directory (~) or project directory:

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

Template project root already includes GEMINI.md file with CloudBase development rules.

If it's an existing project, tell the AI in Gemini CLI:

Download CloudBase AI rules in current project

Launch Gemini CLI:

gemini

Then tell the AI:

Login to CloudBase

Common Commands:

• /tools - View available tools
• /mcp - View MCP server status
• /memory show - View current rules
• !command - Execute Shell command

Update AI Rules

If you want to update to the latest CloudBase AI rules in an existing project, simply tell the AI:

Download CloudBase AI rules

AI will automatically download and update the latest rule configurations to your project directory.

Update MCP Tools

When new versions of MCP tools are released, you can update through:

1. Auto Update (Recommended): In your AI development tool's MCP list, find cloudbase-mcp and re-enable or refresh the MCP list to automatically install the latest version

2. Manual Update: If auto update doesn't work, you can disable and re-enable cloudbase-mcp, or restart your AI IDE

Since the MCP configuration uses the @latest tag, it usually automatically gets the latest version.