# modelcontextprotocol/quickstart-resources architecture

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

- Interactive diagram: https://gitdiagram.com/modelcontextprotocol/quickstart-resources
- Repository: https://github.com/modelcontextprotocol/quickstart-resources

## Overview

##### Project type and purpose
- This repo is a collection of tutorial examples for the Model Context Protocol (MCP).
- It contains two implementations of a weather‐server (Python & TypeScript) and two implementations of an LLM-powered MCP client (Python & TypeScript).
- Purpose: demonstrate how to build a simple MCP weather server and how to build a chatbot client that speaks MCP.

##### File structure
- Top‐level directories:
- mcp-client-python
- mcp-client-typescript
- weather-server-python
- weather-server-typescript
- Each subdirectory is a standalone project:
- python versions use Poetry/uv (pyproject.toml + .python-version + uv.lock + README + main script)
- typescript versions use Node/npm (package.json + tsconfig.json + README + index.ts or src/index.ts)
- There are no shared libraries; each demo is independent.
- No complex build scripts—each uses the standard build/run tooling for its language.

##### README for additional insights
- Confirms two tutorials:
- Quickstart: simple MCP weather‐server
- Building MCP clients: LLM chatbot client

##### Detailed breakdown
- Inside each, note “client.py” or “index.ts” as the entry point.
- Middle layer: “MCP Protocol” as a band or line illustrating the standard interface.
- Inside each, note “weather.py” or “src/index.ts.”
- Blue → green through MCP band: “GET /weather (MCP).”
- Blue → orange: “LLM query/response.”

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Clients"
        direction LR
        MCPClientPy["MCP Client (Python)\n(client.py)"]:::client
        MCPClientTS["MCP Client (TypeScript)\n(index.ts)"]:::client
    end

    MCPProtocol["MCP Protocol\n(interface)"]:::protocol

    subgraph "Servers"
        direction LR
        MCPWeatherServerPy["MCP Weather Server (Python)\n(weather.py)"]:::server
        MCPWeatherServerTS["MCP Weather Server (TypeScript)\n(src/index.ts)"]:::server
    end

    ExternalLLM["External LLM Service"]:::external

    MCPClientPy -->|"MCP request/response"| MCPProtocol
    MCPClientTS -->|"MCP request/response"| MCPProtocol
    MCPProtocol -->|"MCP request/response"| MCPWeatherServerPy
    MCPProtocol -->|"MCP request/response"| MCPWeatherServerTS
    MCPClientPy -->|"LLM prompt/completion"| ExternalLLM
    MCPClientTS -->|"LLM prompt/completion"| ExternalLLM

    click MCPClientPy "https://github.com/modelcontextprotocol/quickstart-resources/blob/main/mcp-client-python/client.py"
    click MCPClientTS "https://github.com/modelcontextprotocol/quickstart-resources/blob/main/mcp-client-typescript/index.ts"
    click MCPWeatherServerPy "https://github.com/modelcontextprotocol/quickstart-resources/blob/main/weather-server-python/weather.py"
    click MCPWeatherServerTS "https://github.com/modelcontextprotocol/quickstart-resources/blob/main/weather-server-typescript/src/index.ts"

    classDef client fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef server fill:#90EE90,stroke:#000,stroke-width:1px
    classDef external fill:#FFA500,stroke:#000,stroke-width:1px
    classDef protocol fill:#D3D3D3,stroke:#000,stroke-width:1px
```
