CloudBase Development Guidelines

💡 Recommended: MCP Installation

For enhanced CloudBase development experience, we recommend installing CloudBase MCP (Model Context Protocol).

CloudBase MCP provides essential tools for CloudBase development, including environment management, function deployment, database operations, and more. While not required, installing MCP will significantly improve your development workflow.

MCP Configuration Instructions

Most Coding Agents support project-level MCP configuration. The standard JSON configuration structure is:

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

Project-level configuration file locations:

• Cursor: .cursor/mcp.json
• Claude Code: .mcp.json
• Windsurf: ~/.codeium/windsurf/mcp_config.json (user-level, no project-level JSON config)
• Cline: Check Cline settings for project-level MCP configuration file location
• GitHub Copilot Chat (VS Code): Check VS Code settings for MCP configuration file location

Format differences:

• Continue: Uses YAML format in .continue/mcpServers/ folder:

name: CloudBase MCP
version: 1.0.0
schema: v1
mcpServers:
  - uses: stdio
    command: npx
    args: ["@cloudbase/cloudbase-mcp@latest"]

Using mcporter (CLI) When MCP Is Not Available

In environments that do not support MCP (e.g. moltbot) or when users are unsure how to configure MCP, use mcporter as a CLI to call CloudBase MCP tools.

You do not need to hard-code Secret ID / Secret Key / Env ID in the config.
CloudBase MCP will support device-code based login via the auth tool, so credentials can be obtained interactively instead of being stored in config.

Add CloudBase MCP server (recommended):

npx mcporter config add cloudbase \
  --command "npx" \
  --arg "@cloudbase/cloudbase-mcp@latest" \
  --description "CloudBase MCP"

Quick start:

• `...