# CloudBase

CloudBase lets an AI coding client work with Tencent CloudBase databases, functions, storage, and hosting. Use it to build and deploy apps from prompts.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 1148
- Author: TencentCloudBase
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/TencentCloudBase/CloudBase-AI-Toolkit/tree/HEAD/mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/cloudbase

## What it does

CloudBase gives the agent tools for PostgreSQL and document databases, data models, CRUD operations, and permissions. It can author, deploy, invoke, and debug cloud functions and Cloud Run services, handle login methods and object storage, publish static hosting or a Mini Program, inspect logs, and redeploy.

The MCP server runs locally with `npx` or connects through a remote HTTP endpoint. Remote OAuth opens browser authorization, while clients without OAuth and CI/CD can use static credentials. Local mode requires `Node.js v18.15.0+`; without that version, the local server will not start. Remote mode cannot upload local files or download templates, and the international site does not expose NoSQL tools.

You need a CloudBase environment before using the server, and critical actions should be confirmed before execution. Deleting functions, collections, documents, or stored files needs a deliberate check.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://tcb-api.cloud.tencent.com/mcp/v1?env_id={env_id}`

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add mcp -- npx -y @cloudbase/cloudbase-mcp
```

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http cloudbase-mcp 'https://tcb-api.cloud.tencent.com/mcp/v1?env_id={env_id}'
```

### Codex

1. **Platform CLI**
```bash
codex mcp add mcp -- npx -y @cloudbase/cloudbase-mcp
```

2. **Platform CLI: remote server**
```bash
codex mcp add mcp --url 'https://tcb-api.cloud.tencent.com/mcp/v1?env_id={env_id}'
```

### Cursor

1. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@cloudbase/cloudbase-mcp"
            ]
        }
    }
}
```

2. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "url": "https://tcb-api.cloud.tencent.com/mcp/v1?env_id={env_id}"
        }
    }
}
```

### GitHub Copilot

1. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@cloudbase/cloudbase-mcp"
            ]
        }
    }
}
```

2. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "http",
            "url": "https://tcb-api.cloud.tencent.com/mcp/v1?env_id={env_id}"
        }
    }
}
```

### Gemini CLI

1. **Platform CLI**
```bash
gemini mcp add mcp npx -y @cloudbase/cloudbase-mcp
```

2. **Platform CLI: remote server**
```bash
gemini mcp add -t http mcp 'https://tcb-api.cloud.tencent.com/mcp/v1?env_id={env_id}'
```

## When to use it
- create database models and set permissions
- deploy and invoke a cloud function
- connect user login with object storage
- publish static hosting and inspect logs
- redeploy an application to CloudBase

## Example prompts
- Connect to CloudBase and list the available environments.
- Build a todo app with login, a database, and permissions, then deploy it through CloudBase.
- Inspect the latest deployment logs and explain the error.

## Similar
- [cloudbase-document-database-in-wechat-miniprogram](https://affpapa.org/en/nevibecode/skills/cloudbase-document-database-in-wechat-miniprogram.md) — skill · 1500 installs
- [relational-database-mcp-cloudbase](https://affpapa.org/en/nevibecode/skills/relational-database-mcp-cloudbase.md) — skill · 956 installs
- [firebase-app-platform](https://affpapa.org/en/nevibecode/skills/firebase-app-platform.md) — skill · 313 installs
- [firebase-data-connect](https://affpapa.org/en/nevibecode/skills/firebase-data-connect.md) — skill · 168800 installs
- [firebase](https://affpapa.org/en/nevibecode/skills/sickn33-firebase.md) — skill · 1600 installs
- [firebase-firestore](https://affpapa.org/en/nevibecode/skills/firebase-firestore.md) — skill · 135400 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md