Alpacacloud MCP Server

by melgencerio.github.Melgencer/alpacacloud-mcpv1.4.2

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

Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Slowing4mo ago

Install Alpacacloud MCP server

claude mcp add alpacacloud -e ALPACACLOUD_URL='<alpacacloud-url>' -e ALPACACLOUD_SERVICE_KEY='<alpacacloud-service-key>' -e ALPACACLOUD_ACCOUNT_TOKEN='<alpacacloud-account-token>' -- npx -y @alpacacloud/mcp

{
  "mcpServers": {
    "alpacacloud": {
      "command": "npx",
      "args": [
        "-y",
        "@alpacacloud/mcp"
      ],
      "env": {
        "ALPACACLOUD_URL": "<alpacacloud-url>",
        "ALPACACLOUD_SERVICE_KEY": "<alpacacloud-service-key>",
        "ALPACACLOUD_ACCOUNT_TOKEN": "<alpacacloud-account-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "alpacacloud": {
      "command": "npx",
      "args": [
        "-y",
        "@alpacacloud/mcp"
      ],
      "env": {
        "ALPACACLOUD_URL": "<alpacacloud-url>",
        "ALPACACLOUD_SERVICE_KEY": "<alpacacloud-service-key>",
        "ALPACACLOUD_ACCOUNT_TOKEN": "<alpacacloud-account-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "alpacacloud": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@alpacacloud/mcp"
      ],
      "env": {
        "ALPACACLOUD_URL": "<alpacacloud-url>",
        "ALPACACLOUD_SERVICE_KEY": "<alpacacloud-service-key>",
        "ALPACACLOUD_ACCOUNT_TOKEN": "<alpacacloud-account-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "alpacacloud": {
      "command": "npx",
      "args": [
        "-y",
        "@alpacacloud/mcp"
      ],
      "env": {
        "ALPACACLOUD_URL": "<alpacacloud-url>",
        "ALPACACLOUD_SERVICE_KEY": "<alpacacloud-service-key>",
        "ALPACACLOUD_ACCOUNT_TOKEN": "<alpacacloud-account-token>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
ALPACACLOUD_URL	yes	—	Your project URL, e.g. https://<project>.alpaca-cloud.com
ALPACACLOUD_SERVICE_KEY	yes	yes	Project service_role key (Database/Auth/Storage tools)
ALPACACLOUD_ACCOUNT_TOKEN	—	yes	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)

Remote endpoints

streamable-httphttps://mcp.alpaca-cloud.com/mcp

Freshness

Slowing — last maintenance signal 4mo ago. The newest of the signals below sets the band.

Last commit (default branch)
no data · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-06-18 · 4mo ago · official registry · v1.4.2

FAQ

›How do I install the Alpacacloud MCP server in Claude Code?

Run: claude mcp add alpacacloud -e ALPACACLOUD_URL='<alpacacloud-url>' -e ALPACACLOUD_SERVICE_KEY='<alpacacloud-service-key>' -e ALPACACLOUD_ACCOUNT_TOKEN='<alpacacloud-account-token>' -- npx -y @alpacacloud/mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Alpacacloud require an API key?

Yes. It expects ALPACACLOUD_URL, ALPACACLOUD_SERVICE_KEY, ALPACACLOUD_ACCOUNT_TOKEN, of which 2 are secrets.

›Can I use Alpacacloud as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Alpacacloud in the official MCP registry?

Yes, as io.github.Melgencer/alpacacloud-mcp.