io.github.Melgencer/alpacacloud-mcp

Official

Connect AI agents to Alpaca Cloud: Postgres, Auth, Storage, Sandboxes, and Workflows.

Provides AI agent access to Alpaca Cloud services including databases, storage, and workflows.

Install

Configuration

Environment variables

ALPACACLOUD_URLrequired

Your project URL, e.g. https://<project>.alpaca-cloud.com

ALPACACLOUD_SERVICE_KEYrequiredsecret

Project service_role key (Database/Auth/Storage tools)

ALPACACLOUD_ACCOUNT_TOKENsecret

Personal access token (alp_pat_…) — unlocks account-wide Sandboxes + Workflows tools

ALPACACLOUD_API_URL

Account API base (default https://api.alpaca-cloud.com)

ALPACACLOUD_SANDBOX_TEMPLATE

Default sandbox image: python | node | base (default python)

ALPACACLOUD_SANDBOX_NETWORK

true to allow outbound network in sandboxes (default false)

claude_desktop_config.json

{
  "mcpServers": {
    "alpacacloud-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@alpacacloud/mcp@1.4.2"
      ],
      "env": {
        "ALPACACLOUD_URL": "<YOUR_ALPACACLOUD_URL>",
        "ALPACACLOUD_SERVICE_KEY": "<YOUR_ALPACACLOUD_SERVICE_KEY>",
        "ALPACACLOUD_ACCOUNT_TOKEN": "<YOUR_ALPACACLOUD_ACCOUNT_TOKEN>",
        "ALPACACLOUD_API_URL": "<YOUR_ALPACACLOUD_API_URL>",
        "ALPACACLOUD_SANDBOX_TEMPLATE": "<YOUR_ALPACACLOUD_SANDBOX_TEMPLATE>",
        "ALPACACLOUD_SANDBOX_NETWORK": "<YOUR_ALPACACLOUD_SANDBOX_NETWORK>"
      }
    }
  }
}