LocalCloud MCP
Local Google Cloud emulation for coding agents, with 25 services in one Docker container
- Pricing
- Free
- Platforms
- macOS, Linux, CLI
- Runs
- Locally
- Version
- 0.1.12
- Listing updated
- 2 days ago
About LocalCloud MCP
LocalCloud MCP is a free MCP server for cloud and infrastructure. It runs locally on your machine and is started by your AI client.
LocalCloud is a runtime that stands in for Google Cloud on localhost, so an agent can build, test and debug against Storage, Pub/Sub, BigQuery, Spanner and similar APIs without a GCP account, credentials or billing. The MCP server is the LocalCloud CLI used as a stdio server, shipped as an .mcpb bundle, and it gives the agent local services, SDK configuration, test data, readiness checks and diagnostics.
Application code keeps using the official Google client libraries. After starting the runtime, the shell exports the endpoint variables that those libraries already look for. Services are chosen in a localcloud.yaml file; Firestore, GKE and Cloud Run are opt-in. Data persists in a named Docker volume, and separate environments can run side by side, for example one for CI.
Docker must be running. The site and README give slightly different service counts (25 on the site, 27 in the README), so check the service pages for the exact list.
Install
Run in a terminal
claude mcp add localcloud -- npx -y https://github.com/LocalGCloud/localcloud-cli/releases/download/v0.1.12/localcloud-mcp-0.1.12.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"localcloud": {
"command": "npx",
"args": [
"-y",
"https://github.com/LocalGCloud/localcloud-cli/releases/download/v0.1.12/localcloud-mcp-0.1.12.mcpb"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"localcloud": {
"command": "npx",
"args": [
"-y",
"https://github.com/LocalGCloud/localcloud-cli/releases/download/v0.1.12/localcloud-mcp-0.1.12.mcpb"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"localcloud": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/LocalGCloud/localcloud-cli/releases/download/v0.1.12/localcloud-mcp-0.1.12.mcpb"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"localcloud": {
"command": "npx",
"args": [
"-y",
"https://github.com/LocalGCloud/localcloud-cli/releases/download/v0.1.12/localcloud-mcp-0.1.12.mcpb"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"localcloud": {
"command": "npx",
"args": [
"-y",
"https://github.com/LocalGCloud/localcloud-cli/releases/download/v0.1.12/localcloud-mcp-0.1.12.mcpb"
]
}
}
}What it does
- Local Google Cloud APIs
- Run services such as Storage, Pub/Sub, BigQuery and Spanner on loopback ports.
- Unchanged SDK code
- Point existing Google client libraries at local endpoints through exported environment variables.
- Persistent volumes
- Keep data between runs in a named Docker volume.
- Repository guidance
- The site tells agents to read AGENTS.md and match services to what the repo uses.
- Signed releases
- CLI releases come with Sigstore signatures and SHA-256 checksums.
- Terraform and CI setup
- Documentation covers SDKs, MCP, Terraform and CI fixtures.
Good for
- Run integration tests against BigQuery and Pub/Sub without a cloud project
- Let a coding agent debug a Google Cloud app offline
- Give CI runners a throwaway Google Cloud environment
- Try a service locally before paying for it in the cloud
Pricing
Free
Free during public preview; free for open-source projects and individual developers
Prices change. Check local.cloud before you buy.
LocalCloud MCP FAQ
Is it free?
Yes during the public preview, including the Pro-tier services. Free use for open-source projects and individual developers continues after the preview.
Do I need a Google Cloud account?
No account, credentials or billing are needed for local workflows.
What does it need?
Docker running and the LocalCloud CLI, installed with brew or the install script.
Is it for production?
No. The pricing page describes it for non-production development, testing and CI.
Is LocalCloud MCP free?
Yes. LocalCloud MCP is free to use.
How do I add LocalCloud MCP to Claude Code?
Run this command in your terminal: claude mcp add localcloud -- npx -y https://github.com/LocalGCloud/localcloud-cli/releases/download/v0.1.12/localcloud-mcp-0.1.12.mcpb
What are the best alternatives to LocalCloud MCP?
The closest alternatives to LocalCloud MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to LocalCloud MCP

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools