# google/mcp architecture

> Architecture diagram of the GitHub repository google/mcp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/google/mcp
- Repository: https://github.com/google/mcp

## Overview

This repository is primarily a catalog of Google MCP servers and deployment resources, with sample applications illustrating MCP use. The README documents the examples’ integrations and the catalog categories; no source excerpts were provided, so implementation-level flow is not shown.

Main entry points: [`examples/allstrides`](https://github.com/google/mcp/tree/main/examples/allstrides) (Allstrides App), [`README.md`](https://github.com/google/mcp/blob/main/README.md) (Server Listings), [`examples/launchmybakery/README.md`](https://github.com/google/mcp/blob/main/examples/launchmybakery/README.md) (Launch My Bakery)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["MCP Server Catalog"]
  node_catalog["Server Listings<br/>[README.md]"]
  node_remote["Remote Servers<br/>[README.md]"]
  node_oss["Open-source Servers<br/>[README.md]"]
  node_remote_products["Google Cloud Products<br/>[README.md]"]
  node_oss_products["Community Servers<br/>[README.md]"]
end

subgraph group_guidance["Cloud Deployment Guidance"]
  node_deployment["Cloud Run Hosting<br/>[README.md]"]
  node_toolbox["Toolbox Deployment<br/>[README.md]"]
  node_other_guidance["Hosting Resources<br/>[README.md]"]
end

subgraph group_examples["Sample Applications"]
  node_bakery["Launch My Bakery<br/>[README.md]"]
  node_allstrides["Allstrides App"]
end

node_reader(("Developer"))
node_maps["Google Maps MCP"]
node_bigquery["BigQuery MCP"]
node_dev_knowledge["Developer Knowledge MCP"]
node_cloud_sql["Cloud SQL MCP"]
node_cloud_run["Cloud Run MCP"]

node_reader -->|"browses"| node_catalog
node_catalog -->|"lists"| node_remote
node_catalog -->|"lists"| node_oss
node_remote -->|"includes"| node_remote_products
node_oss -->|"includes"| node_oss_products
node_reader -->|"consults"| node_deployment
node_reader -->|"consults"| node_toolbox
node_reader -->|"consults"| node_other_guidance
node_reader -->|"explores"| node_bakery
node_bakery -->|"uses"| node_maps
node_bakery -->|"uses"| node_bigquery
node_reader -->|"explores"| node_allstrides
node_allstrides -->|"uses"| node_dev_knowledge
node_allstrides -->|"uses"| node_cloud_sql
node_allstrides -->|"uses"| node_cloud_run

click node_catalog "https://github.com/google/mcp/blob/main/README.md"
click node_remote "https://github.com/google/mcp/blob/main/README.md"
click node_oss "https://github.com/google/mcp/blob/main/README.md"
click node_remote_products "https://github.com/google/mcp/blob/main/README.md"
click node_oss_products "https://github.com/google/mcp/blob/main/README.md"
click node_deployment "https://github.com/google/mcp/blob/main/README.md"
click node_toolbox "https://github.com/google/mcp/blob/main/README.md"
click node_other_guidance "https://github.com/google/mcp/blob/main/README.md"
click node_bakery "https://github.com/google/mcp/blob/main/examples/launchmybakery/README.md"
click node_allstrides "https://github.com/google/mcp/tree/main/examples/allstrides"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_catalog,node_remote,node_oss,node_remote_products,node_oss_products toneBlue
class node_deployment,node_toolbox,node_other_guidance toneAmber
class node_bakery,node_allstrides toneMint
class node_reader,node_maps,node_bigquery,node_dev_knowledge,node_cloud_sql,node_cloud_run toneIndigo
```

## Components

### MCP Server Catalog

- [Server Listings](https://github.com/google/mcp/blob/main/README.md): `README.md`
- [Remote Servers](https://github.com/google/mcp/blob/main/README.md): `README.md`
- [Open-source Servers](https://github.com/google/mcp/blob/main/README.md): `README.md`
- [Google Cloud Products](https://github.com/google/mcp/blob/main/README.md): `README.md`
- [Community Servers](https://github.com/google/mcp/blob/main/README.md): `README.md`

### Cloud Deployment Guidance

- [Cloud Run Hosting](https://github.com/google/mcp/blob/main/README.md): `README.md`
- [Toolbox Deployment](https://github.com/google/mcp/blob/main/README.md): `README.md`
- [Hosting Resources](https://github.com/google/mcp/blob/main/README.md): `README.md`

### Sample Applications

- [Launch My Bakery](https://github.com/google/mcp/blob/main/examples/launchmybakery/README.md): `examples/launchmybakery/README.md`
- [Allstrides App](https://github.com/google/mcp/tree/main/examples/allstrides): `examples/allstrides`

### Other components

- **Developer**
- **Google Maps MCP**
- **BigQuery MCP**
- **Developer Knowledge MCP**
- **Cloud SQL MCP**
- **Cloud Run MCP**

## Connections

- Developer → Server Listings: browses (evidence: `README.md`)
- Server Listings → Remote Servers: lists (evidence: `README.md`)
- Server Listings → Open-source Servers: lists (evidence: `README.md`)
- Remote Servers → Google Cloud Products: includes (evidence: `README.md`)
- Open-source Servers → Community Servers: includes (evidence: `README.md`)
- Developer → Cloud Run Hosting: consults (evidence: `README.md`)
- Developer → Toolbox Deployment: consults (evidence: `README.md`)
- Developer → Hosting Resources: consults (evidence: `README.md`)
- Developer → Launch My Bakery: explores (evidence: `README.md`)
- Launch My Bakery → Google Maps MCP: uses (evidence: `README.md`)
- Launch My Bakery → BigQuery MCP: uses (evidence: `README.md`)
- Developer → Allstrides App: explores (evidence: `README.md`)
- Allstrides App → Developer Knowledge MCP: uses (evidence: `README.md`)
- Allstrides App → Cloud SQL MCP: uses (evidence: `README.md`)
- Allstrides App → Cloud Run MCP: uses (evidence: `README.md`)
