# microsoft/mcp architecture

> Architecture diagram of the GitHub repository microsoft/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/microsoft/mcp
- Repository: https://github.com/microsoft/mcp

## Overview

This repository provides Microsoft MCP servers, chiefly Azure and Fabric, plus shared runtime libraries. The main user workflow is an MCP host connecting to a server and using its tools; Azure tools span resource operations, data queries, monitoring ingestion, and Storage Sync management. Shared layers include tool loading and command responses, with Azure services providing cloud access. The README establishes the server role, while sampled sources show selected command-to-service calls; other tool connections are omitted where implementation evidence was unavailable.

Main entry points: [`core/Azure.Mcp.Core/src/Services/Azure/AzureService.cs`](https://github.com/microsoft/mcp/blob/main/core/Azure.Mcp.Core/src/Services/Azure/AzureService.cs) (Azure Core Services), [`tools/Azure.Mcp.Tools.Postgres/src/Commands/Database/DatabaseQueryCommand.cs`](https://github.com/microsoft/mcp/blob/main/tools/Azure.Mcp.Tools.Postgres/src/Commands/Database/DatabaseQueryCommand.cs) (PostgreSQL Query), [`tools/Azure.Mcp.Tools.Monitor/src/Services/MonitorIngestionService.cs`](https://github.com/microsoft/mcp/blob/main/tools/Azure.Mcp.Tools.Monitor/src/Services/MonitorIngestionService.cs) (Monitor Ingestion), [`tools/Azure.Mcp.Tools.StorageSync/src/Services/StorageSyncService.cs`](https://github.com/microsoft/mcp/blob/main/tools/Azure.Mcp.Tools.StorageSync/src/Services/StorageSyncService.cs) (Storage Sync)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_protocol["MCP Server"]
  node_azure_server["Azure Server<br/>[Program.cs]"]
  node_fabric_server["Fabric Server<br/>[Program.cs]"]
end

subgraph group_runtime["Shared Runtime"]
  node_tool_loading["Tool Loading<br/>[ToolLoading]"]
  node_discovery["Server Discovery<br/>[Discovery]"]
  node_command_response["Command Response<br/>[CommandResponse.cs]"]
end

subgraph group_azure["Azure Access"]
  node_azure_core["Azure Core Services<br/>[AzureService.cs]"]
end

subgraph group_capabilities["Tool Capabilities"]
  node_postgres_query["PostgreSQL Query"]
  node_postgres_service["PostgreSQL Service<br/>[Services]"]
  node_monitor_ingestion["Monitor Ingestion"]
  node_storage_sync["Storage Sync"]
  node_storage_tools["Storage Tools"]
  node_fabric_data_factory["Fabric Data Factory"]
end

node_host(("MCP Host"))
node_azure_external[("Azure Services")]

node_host -->|"connects to"| node_azure_server
node_host -->|"connects to"| node_fabric_server
node_postgres_query -->|"executes query"| node_postgres_service
node_postgres_query -->|"sets results"| node_command_response
node_monitor_ingestion -->|"uses Azure access"| node_azure_core
node_storage_sync -->|"uses Azure access"| node_azure_core
node_azure_core -->|"accesses cloud"| node_azure_external

click node_azure_server "https://github.com/microsoft/mcp/blob/main/servers/Azure.Mcp.Server/src/Program.cs"
click node_fabric_server "https://github.com/microsoft/mcp/blob/main/servers/Fabric.Mcp.Server/src/Program.cs"
click node_tool_loading "https://github.com/microsoft/mcp/tree/main/core/Microsoft.Mcp.Core/src/Areas/Server/Commands/ToolLoading"
click node_discovery "https://github.com/microsoft/mcp/tree/main/core/Microsoft.Mcp.Core/src/Areas/Server/Commands/Discovery"
click node_command_response "https://github.com/microsoft/mcp/blob/main/core/Microsoft.Mcp.Core/src/Models/Command/CommandResponse.cs"
click node_azure_core "https://github.com/microsoft/mcp/blob/main/core/Azure.Mcp.Core/src/Services/Azure/AzureService.cs"
click node_postgres_query "https://github.com/microsoft/mcp/blob/main/tools/Azure.Mcp.Tools.Postgres/src/Commands/Database/DatabaseQueryCommand.cs"
click node_postgres_service "https://github.com/microsoft/mcp/tree/main/tools/Azure.Mcp.Tools.Postgres/src/Services"
click node_monitor_ingestion "https://github.com/microsoft/mcp/blob/main/tools/Azure.Mcp.Tools.Monitor/src/Services/MonitorIngestionService.cs"
click node_storage_sync "https://github.com/microsoft/mcp/blob/main/tools/Azure.Mcp.Tools.StorageSync/src/Services/StorageSyncService.cs"
click node_storage_tools "https://github.com/microsoft/mcp/tree/main/tools/Azure.Mcp.Tools.Storage"
click node_fabric_data_factory "https://github.com/microsoft/mcp/blob/main/tools/Fabric.Mcp.Tools.DataFactory/src/Commands/Pipeline/CreatePipelineCommand.cs"

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_azure_server,node_fabric_server toneBlue
class node_tool_loading,node_discovery,node_command_response,node_azure_external toneAmber
class node_azure_core toneMint
class node_postgres_query,node_postgres_service,node_monitor_ingestion,node_storage_sync,node_storage_tools,node_fabric_data_factory toneRose
class node_host toneIndigo
```

## Components

### MCP Server

- [Azure Server](https://github.com/microsoft/mcp/blob/main/servers/Azure.Mcp.Server/src/Program.cs): `servers/Azure.Mcp.Server/src/Program.cs`
- [Fabric Server](https://github.com/microsoft/mcp/blob/main/servers/Fabric.Mcp.Server/src/Program.cs): `servers/Fabric.Mcp.Server/src/Program.cs`

### Shared Runtime

- [Tool Loading](https://github.com/microsoft/mcp/tree/main/core/Microsoft.Mcp.Core/src/Areas/Server/Commands/ToolLoading): `core/Microsoft.Mcp.Core/src/Areas/Server/Commands/ToolLoading`
- [Server Discovery](https://github.com/microsoft/mcp/tree/main/core/Microsoft.Mcp.Core/src/Areas/Server/Commands/Discovery): `core/Microsoft.Mcp.Core/src/Areas/Server/Commands/Discovery`
- [Command Response](https://github.com/microsoft/mcp/blob/main/core/Microsoft.Mcp.Core/src/Models/Command/CommandResponse.cs): `core/Microsoft.Mcp.Core/src/Models/Command/CommandResponse.cs`

### Azure Access

- [Azure Core Services](https://github.com/microsoft/mcp/blob/main/core/Azure.Mcp.Core/src/Services/Azure/AzureService.cs): `core/Azure.Mcp.Core/src/Services/Azure/AzureService.cs`

### Tool Capabilities

- [PostgreSQL Query](https://github.com/microsoft/mcp/blob/main/tools/Azure.Mcp.Tools.Postgres/src/Commands/Database/DatabaseQueryCommand.cs): `tools/Azure.Mcp.Tools.Postgres/src/Commands/Database/DatabaseQueryCommand.cs`
- [PostgreSQL Service](https://github.com/microsoft/mcp/tree/main/tools/Azure.Mcp.Tools.Postgres/src/Services): `tools/Azure.Mcp.Tools.Postgres/src/Services`
- [Monitor Ingestion](https://github.com/microsoft/mcp/blob/main/tools/Azure.Mcp.Tools.Monitor/src/Services/MonitorIngestionService.cs): `tools/Azure.Mcp.Tools.Monitor/src/Services/MonitorIngestionService.cs`
- [Storage Sync](https://github.com/microsoft/mcp/blob/main/tools/Azure.Mcp.Tools.StorageSync/src/Services/StorageSyncService.cs): `tools/Azure.Mcp.Tools.StorageSync/src/Services/StorageSyncService.cs`
- [Storage Tools](https://github.com/microsoft/mcp/tree/main/tools/Azure.Mcp.Tools.Storage): `tools/Azure.Mcp.Tools.Storage`
- [Fabric Data Factory](https://github.com/microsoft/mcp/blob/main/tools/Fabric.Mcp.Tools.DataFactory/src/Commands/Pipeline/CreatePipelineCommand.cs): `tools/Fabric.Mcp.Tools.DataFactory/src/Commands/Pipeline/CreatePipelineCommand.cs`

### Other components

- **MCP Host**
- **Azure Services**

## Connections

- MCP Host → Azure Server: connects to (evidence: `README.md`)
- MCP Host → Fabric Server: connects to (evidence: `README.md`)
- PostgreSQL Query → PostgreSQL Service: executes query (evidence: `tools/Azure.Mcp.Tools.Postgres/src/Commands/Database/DatabaseQueryCommand.cs`)
- PostgreSQL Query → Command Response: sets results (evidence: `tools/Azure.Mcp.Tools.Postgres/src/Commands/Database/DatabaseQueryCommand.cs`)
- Monitor Ingestion → Azure Core Services: uses Azure access (evidence: `tools/Azure.Mcp.Tools.Monitor/src/Services/MonitorIngestionService.cs`)
- Storage Sync → Azure Core Services: uses Azure access (evidence: `tools/Azure.Mcp.Tools.StorageSync/src/Services/StorageSyncService.cs`)
- Azure Core Services → Azure Services: accesses cloud (evidence: `core/Azure.Mcp.Core/src/Services/Azure/AzureService.cs`)
