# awslabs/mcp architecture

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

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

## Overview

This repository is a suite of specialized AWS Model Context Protocol (MCP) servers. An MCP host/client connects to a server, which exposes AWS-specific tools and context to the host; the README says these servers support stdio transport. The tree shows a broad catalog spanning data, infrastructure, AI, operations, and healthcare, alongside a particularly extensive AgentCore server. Relationships between individual server implementations and AWS services are not established by the sampled source, so the map uses the README’s suite-level description and leaves those internal links out.

Main entry points: [`src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/server.py`](https://github.com/awslabs/mcp/blob/main/src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/server.py) (AgentCore server), [`src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/tools/policy/engines.py`](https://github.com/awslabs/mcp/blob/main/src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/tools/policy/engines.py) (Policy tools), [`src/postgres-mcp-server/awslabs/postgres_mcp_server/server.py`](https://github.com/awslabs/mcp/blob/main/src/postgres-mcp-server/awslabs/postgres_mcp_server/server.py) (Postgres server), [`src/aws-dataprocessing-mcp-server/awslabs/aws_dataprocessing_mcp_server/handlers/athena/athena_query_handler.py`](https://github.com/awslabs/mcp/blob/main/src/aws-dataprocessing-mcp-server/awslabs/aws_dataprocessing_mcp_server/handlers/athena/athena_query_handler.py) (Athena queries)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_protocol["MCP access"]
  node_servers["AWS MCP servers"]
end

subgraph group_agentcore["AgentCore tools"]
  node_agentcore_server["AgentCore server<br/>[server.py]"]
  node_policy["Policy tools<br/>[engines.py]"]
  node_policy_models["Policy models<br/>[models.py]"]
  node_browser["Browser tools"]
  node_interpreter["Code interpreter"]
  node_gateway["Gateway tools"]
  node_identity["Identity tools"]
  node_memory["Memory tools"]
  node_runtime["Runtime tools"]
end

subgraph group_data["Data services"]
  node_postgres["Postgres server<br/>[server.py]"]
  node_mutable_sql["SQL safety"]
  node_athena["Athena queries"]
  node_redshift["Redshift server<br/>[server.py]"]
end

subgraph group_cloud["Cloud operations"]
  node_pricing["Pricing server<br/>[server.py]"]
  node_iam["IAM server<br/>[server.py]"]
end

subgraph group_specialized["Specialized domains"]
  node_healthomics["HealthOmics search"]
  node_s3_search["S3 genomics search"]
  node_translate["Translation server<br/>[server.py]"]
  node_kendra["Kendra server<br/>[server.py]"]
end

node_host(("MCP host"))

node_host -->|"connects via MCP"| node_servers
node_host -->|"connects via MCP"| node_agentcore_server
node_host -->|"connects via MCP"| node_postgres
node_host -->|"connects via MCP"| node_athena
node_host -->|"connects via MCP"| node_healthomics
node_host -->|"connects via MCP"| node_pricing
node_host -->|"connects via MCP"| node_iam
node_host -->|"connects via MCP"| node_redshift
node_host -->|"connects via MCP"| node_translate
node_host -->|"connects via MCP"| node_kendra
node_agentcore_server -.-> node_policy

click node_agentcore_server "https://github.com/awslabs/mcp/blob/main/src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/server.py"
click node_policy "https://github.com/awslabs/mcp/blob/main/src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/tools/policy/engines.py"
click node_policy_models "https://github.com/awslabs/mcp/blob/main/src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/tools/policy/models.py"
click node_browser "https://github.com/awslabs/mcp/tree/main/src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/tools/browser"
click node_interpreter "https://github.com/awslabs/mcp/tree/main/src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/tools/code_interpreter"
click node_gateway "https://github.com/awslabs/mcp/tree/main/src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/tools/gateway"
click node_identity "https://github.com/awslabs/mcp/tree/main/src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/tools/identity"
click node_memory "https://github.com/awslabs/mcp/tree/main/src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/tools/memory"
click node_runtime "https://github.com/awslabs/mcp/tree/main/src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/tools/runtime"
click node_postgres "https://github.com/awslabs/mcp/blob/main/src/postgres-mcp-server/awslabs/postgres_mcp_server/server.py"
click node_mutable_sql "https://github.com/awslabs/mcp/blob/main/src/aurora-dsql-mcp-server/awslabs/aurora_dsql_mcp_server/mutable_sql_detector.py"
click node_athena "https://github.com/awslabs/mcp/blob/main/src/aws-dataprocessing-mcp-server/awslabs/aws_dataprocessing_mcp_server/handlers/athena/athena_query_handler.py"
click node_healthomics "https://github.com/awslabs/mcp/blob/main/src/aws-healthomics-mcp-server/awslabs/aws_healthomics_mcp_server/search/healthomics_search_engine.py"
click node_s3_search "https://github.com/awslabs/mcp/blob/main/src/aws-healthomics-mcp-server/awslabs/aws_healthomics_mcp_server/search/s3_search_engine.py"
click node_pricing "https://github.com/awslabs/mcp/blob/main/src/aws-pricing-mcp-server/awslabs/aws_pricing_mcp_server/server.py"
click node_iam "https://github.com/awslabs/mcp/blob/main/src/iam-mcp-server/awslabs/iam_mcp_server/server.py"
click node_redshift "https://github.com/awslabs/mcp/blob/main/src/redshift-mcp-server/awslabs/redshift_mcp_server/server.py"
click node_translate "https://github.com/awslabs/mcp/blob/main/src/amazon-translate-mcp-server/awslabs/amazon_translate_mcp_server/server.py"
click node_kendra "https://github.com/awslabs/mcp/blob/main/src/amazon-kendra-index-mcp-server/awslabs/amazon_kendra_index_mcp_server/server.py"

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_servers toneBlue
class node_agentcore_server,node_policy,node_policy_models,node_browser,node_interpreter,node_gateway,node_identity,node_memory,node_runtime toneAmber
class node_postgres,node_mutable_sql,node_athena,node_redshift toneMint
class node_pricing,node_iam toneRose
class node_healthomics,node_s3_search,node_translate,node_kendra,node_host toneIndigo
```

## Components

### MCP access

- **AWS MCP servers**

### AgentCore tools

- [AgentCore server](https://github.com/awslabs/mcp/blob/main/src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/server.py): `src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/server.py`
- [Policy tools](https://github.com/awslabs/mcp/blob/main/src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/tools/policy/engines.py): `src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/tools/policy/engines.py`
- [Policy models](https://github.com/awslabs/mcp/blob/main/src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/tools/policy/models.py): `src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/tools/policy/models.py`
- [Browser tools](https://github.com/awslabs/mcp/tree/main/src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/tools/browser): `src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/tools/browser`
- [Code interpreter](https://github.com/awslabs/mcp/tree/main/src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/tools/code_interpreter): `src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/tools/code_interpreter`
- [Gateway tools](https://github.com/awslabs/mcp/tree/main/src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/tools/gateway): `src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/tools/gateway`
- [Identity tools](https://github.com/awslabs/mcp/tree/main/src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/tools/identity): `src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/tools/identity`
- [Memory tools](https://github.com/awslabs/mcp/tree/main/src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/tools/memory): `src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/tools/memory`
- [Runtime tools](https://github.com/awslabs/mcp/tree/main/src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/tools/runtime): `src/amazon-bedrock-agentcore-mcp-server/awslabs/amazon_bedrock_agentcore_mcp_server/tools/runtime`

### Data services

- [Postgres server](https://github.com/awslabs/mcp/blob/main/src/postgres-mcp-server/awslabs/postgres_mcp_server/server.py): `src/postgres-mcp-server/awslabs/postgres_mcp_server/server.py`
- [SQL safety](https://github.com/awslabs/mcp/blob/main/src/aurora-dsql-mcp-server/awslabs/aurora_dsql_mcp_server/mutable_sql_detector.py): `src/aurora-dsql-mcp-server/awslabs/aurora_dsql_mcp_server/mutable_sql_detector.py`
- [Athena queries](https://github.com/awslabs/mcp/blob/main/src/aws-dataprocessing-mcp-server/awslabs/aws_dataprocessing_mcp_server/handlers/athena/athena_query_handler.py): `src/aws-dataprocessing-mcp-server/awslabs/aws_dataprocessing_mcp_server/handlers/athena/athena_query_handler.py`
- [Redshift server](https://github.com/awslabs/mcp/blob/main/src/redshift-mcp-server/awslabs/redshift_mcp_server/server.py): `src/redshift-mcp-server/awslabs/redshift_mcp_server/server.py`

### Cloud operations

- [Pricing server](https://github.com/awslabs/mcp/blob/main/src/aws-pricing-mcp-server/awslabs/aws_pricing_mcp_server/server.py): `src/aws-pricing-mcp-server/awslabs/aws_pricing_mcp_server/server.py`
- [IAM server](https://github.com/awslabs/mcp/blob/main/src/iam-mcp-server/awslabs/iam_mcp_server/server.py): `src/iam-mcp-server/awslabs/iam_mcp_server/server.py`

### Specialized domains

- [HealthOmics search](https://github.com/awslabs/mcp/blob/main/src/aws-healthomics-mcp-server/awslabs/aws_healthomics_mcp_server/search/healthomics_search_engine.py): `src/aws-healthomics-mcp-server/awslabs/aws_healthomics_mcp_server/search/healthomics_search_engine.py`
- [S3 genomics search](https://github.com/awslabs/mcp/blob/main/src/aws-healthomics-mcp-server/awslabs/aws_healthomics_mcp_server/search/s3_search_engine.py): `src/aws-healthomics-mcp-server/awslabs/aws_healthomics_mcp_server/search/s3_search_engine.py`
- [Translation server](https://github.com/awslabs/mcp/blob/main/src/amazon-translate-mcp-server/awslabs/amazon_translate_mcp_server/server.py): `src/amazon-translate-mcp-server/awslabs/amazon_translate_mcp_server/server.py`
- [Kendra server](https://github.com/awslabs/mcp/blob/main/src/amazon-kendra-index-mcp-server/awslabs/amazon_kendra_index_mcp_server/server.py): `src/amazon-kendra-index-mcp-server/awslabs/amazon_kendra_index_mcp_server/server.py`

### Other components

- **MCP host**

## Connections

- MCP host → AWS MCP servers: connects via MCP (evidence: `README.md`)
- MCP host → AgentCore server: connects via MCP (evidence: `README.md`)
- MCP host → Postgres server: connects via MCP (evidence: `README.md`)
- MCP host → Athena queries: connects via MCP (evidence: `README.md`)
- MCP host → HealthOmics search: connects via MCP (evidence: `README.md`)
- MCP host → Pricing server: connects via MCP (evidence: `README.md`)
- MCP host → IAM server: connects via MCP (evidence: `README.md`)
- MCP host → Redshift server: connects via MCP (evidence: `README.md`)
- MCP host → Translation server: connects via MCP (evidence: `README.md`)
- MCP host → Kendra server: connects via MCP (evidence: `README.md`)
- AgentCore server → Policy tools
