# LocalCloud MCP

Connects your coding agent to a local Docker-based Google Cloud runtime for tests and debugging. Useful when building cloud services without incurring live provider fees.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 1
- Author: LocalGCloud
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/LocalGCloud/localcloud-cli
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/localcloud-mcp

## What it does

The tool manages a local Google Cloud emulation container through the host CLI `localcloud` (aliased `lc`). Its MCP bridge exposes actions for provisioning resources, seeding fixtures, checking readiness, and resetting state directly within the agent workflow. Existing application code calls regular Google Cloud client libraries: running `eval "$(lc env)"` sets environment variables to point endpoints to loopback.

Up to 27 services run inside a single container, including Storage, Pub/Sub, BigQuery, Spanner, and Bigtable. Data survives container restarts thanks to a named Docker volume. The CLI validates emitted endpoints to prevent requests from routing out to production `googleapis.com` infrastructure.

Running the stack requires Docker Engine, Docker Desktop, Colima, OrbStack, or Rancher Desktop with at least 4 GiB of memory assigned. On Apple Silicon, configure the Docker VM with VZ and Rosetta rather than QEMU, which triggers known failures in the BigQuery emulator.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- Emulate Google Cloud services locally without creating live paid infrastructure
- Grant coding agents tools to provision and reset cloud state via MCP
- Persist test datasets across restarts using a named Docker volume
- Configure client library environment variables for loopback endpoints

## Example prompts
- "Check the LocalCloud environment status with `lc doctor`"
- "Start LocalCloud services and export environment variables for client libraries"
- "Create a test Pub/Sub topic and Storage bucket inside the local container"

## Similar
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902
- [Coder](https://affpapa.org/en/nevibecode/mcp/coder.md) — MCP server · ★ 17191
- [firebase-mcp](https://affpapa.org/en/nevibecode/mcp/firebase-mcp.md) — MCP server · ★ 4482
- [Radar Kubernetes MCP Server](https://affpapa.org/en/nevibecode/mcp/radar-kubernetes-mcp-server.md) — MCP server · ★ 3918
- [Supabase](https://affpapa.org/en/nevibecode/mcp/supabase.md) — MCP server · ★ 2974
- [Microsoft Fabric MCP Server](https://affpapa.org/en/nevibecode/mcp/microsoft-fabric-mcp-server.md) — MCP server · ★ 3804

---
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