cloudbase

SKILL.md 节选

# CloudBase Development Guidelines

## 📁 Reference Files Location

All reference documentation files are located in the `references/` directory relative to this file.

**File Structure:**
```
cloudbase/
├── SKILL.md              # This file (main entry)
└── references/           # All reference documentation
    ├── auth-web/         # Web authentication guide
    ├── auth-wechat/      # WeChat authentication guide
    ├── no-sql-web-sdk/   # NoSQL database for Web
    ├── ui-design/        # UI design guidelines
    └── ...               # Other reference docs
```

**How to use:** When this document mentions reading a reference file like `references/auth-web/README.md`, simply read that file from the `references/` subdirectory.

---


## 💡 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:
```json
{
  "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:
```yaml
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. openclaw) or when users are unsure how to configure MCP, use **mcporter** as a CLI to call CloudBase MCP tools.

**When managing or deploying CloudBase, you MUST use MCP and MUST understand tool details first.** Before calling any CloudBase tool, run `npx mcporter describe cloudbase` (or equivalent in your IDE) to inspect the server config and available 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):**

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

**Quick start:**
- `npx mcporter list` — list configured servers
- **Required:** `npx mcporter describe cloudbase` — inspect CloudBase server config and available tools (must run before managing/deploying CloudBase)
- `npx mcporter list cloudbase --schema` — get full JSON schema for all CloudBase tools
- `npx mcporter call cloudbase.help --output json` — discover available CloudBase tools and their schemas
- `npx mcporter call cloudbase.<tool> key=value` — call a CloudBase tool

**Call examples (CloudBase auth):**
- Check auth & env status:  
  `npx mcporter call cloudbase.auth action=status --output json`
- Start device-flow login (future-friendly device-code login; no keys in config):  
  `npx mcporter call cloudbase.auth action=start_auth authMode=device --output json`
- Bind environment after login (envId from CloudBase console):  
  `npx mcporter call cloudbase.auth action=set_env envId=env-xxx --output json`

---

## CloudBase scenarios (for AI discovery)

SKILL.md 不止这些内容，安装后可阅读全文。

技能包内容

共 42 个文件，合计 361.6 KiB