# khubaib-96/model-context-protocol architecture

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

- Interactive diagram: https://gitdiagram.com/khubaib-96/model-context-protocol
- Repository: https://github.com/khubaib-96/model-context-protocol

## Overview

This repository is an educational collection of Model Context Protocol (MCP) labs, not one integrated application. Its recurring workflow is to start an MCP server, connect a client, and use tools, resources, or prompts; some examples add HTTP transport, an LLM agent, or permission controls. The graph preserves the documented lab branches and the sampled interaction host’s planner/agent responsibilities. Several server and client relationships are described only as general workflows in the README, so those edges are documented at the collection level rather than asserting specific pairings.

Main entry points: [`MCP_interactions/host.py`](https://github.com/khubaib-96/model-context-protocol/blob/main/MCP_interactions/host.py) (Request Host), [`mcp_security_lab/mcp_permission_client_base.py`](https://github.com/khubaib-96/model-context-protocol/blob/main/mcp_security_lab/mcp_permission_client_base.py) (Permission Client), [`mcp_advanced_lab/mcp_http_client_app.py`](https://github.com/khubaib-96/model-context-protocol/blob/main/mcp_advanced_lab/mcp_http_client_app.py) (HTTP Client App), [`mcp_advanced_lab/mcp_http_host_app.py`](https://github.com/khubaib-96/model-context-protocol/blob/main/mcp_advanced_lab/mcp_http_host_app.py) (LLM HTTP Host)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Core MCP Examples"]
  node_basic["Starter Example<br/>[basic_MCP.py]"]
  node_enhanced_server["File Operations Server<br/>[server.py]"]
  node_enhanced_client["Enhanced Client<br/>[client.py]"]
  node_client_lab_client["STDIO Client<br/>[mcp_client.py]"]
  node_client_lab_server["Client Lab Server<br/>[mcp_server.py]"]
end

subgraph group_interactions["Agent Interactions"]
  node_interaction_host["Request Host<br/>[host.py]"]
  node_interaction_planner["Capability Planner<br/>[planner.py]"]
  node_interaction_agent["Tool Agent<br/>[agent.py]"]
  node_interaction_client["MCP Session Client<br/>[mcp_client.py]"]
  node_interaction_server["Native MCP Server<br/>[server.py]"]
end

subgraph group_http["HTTP Labs"]
  node_http_server["HTTP Server<br/>[mcp_http_server.py]"]
  node_http_client_base["HTTP Protocol Client"]
  node_http_client_app["HTTP Client App"]
  node_http_host_app["LLM HTTP Host"]
end

subgraph group_security["Security Lab"]
  node_permission_server["Permission Server"]
  node_permission_client_base["Permission Client"]
  node_permission_client_app["Permission Client App"]
  node_permission_host_app["Permission LLM Host"]
  node_permission_store[("Policy and Audit Files<br/>[permissions.json]")]
end

node_user(("Learner"))

node_user -->|"runs example"| node_basic
node_user -->|"starts server"| node_enhanced_server
node_user -->|"connects client"| node_client_lab_client
node_user -->|"sends request"| node_interaction_host
node_interaction_host -->|"plans route"| node_interaction_planner
node_interaction_host -->|"invokes agent"| node_interaction_agent
node_interaction_host -->|"opens session"| node_interaction_client
node_user -->|"uses HTTP lab"| node_http_client_app
node_user -->|"requests agent"| node_http_host_app
node_http_client_app -->|"extends client"| node_http_client_base
node_http_host_app -->|"extends client"| node_http_client_base
node_user -->|"uses security lab"| node_permission_client_app
node_user -->|"requests protected tools"| node_permission_host_app
node_permission_client_app -->|"uses permission client"| node_permission_client_base
node_permission_host_app -->|"uses permission client"| node_permission_client_base
node_permission_client_base -->|"loads policy"| node_permission_store
node_permission_client_base -->|"writes audit log"| node_permission_store

click node_basic "https://github.com/khubaib-96/model-context-protocol/blob/main/basic_MCP.py"
click node_enhanced_server "https://github.com/khubaib-96/model-context-protocol/blob/main/enhanced_MCP_server/server.py"
click node_enhanced_client "https://github.com/khubaib-96/model-context-protocol/blob/main/enhanced_MCP_server/client.py"
click node_client_lab_client "https://github.com/khubaib-96/model-context-protocol/blob/main/mcp_client_lab/mcp_client.py"
click node_client_lab_server "https://github.com/khubaib-96/model-context-protocol/blob/main/mcp_client_lab/mcp_server.py"
click node_interaction_host "https://github.com/khubaib-96/model-context-protocol/blob/main/MCP_interactions/host.py"
click node_interaction_planner "https://github.com/khubaib-96/model-context-protocol/blob/main/MCP_interactions/planner.py"
click node_interaction_agent "https://github.com/khubaib-96/model-context-protocol/blob/main/MCP_interactions/agent.py"
click node_interaction_client "https://github.com/khubaib-96/model-context-protocol/blob/main/MCP_interactions/mcp_client.py"
click node_interaction_server "https://github.com/khubaib-96/model-context-protocol/blob/main/MCP_interactions/server.py"
click node_http_server "https://github.com/khubaib-96/model-context-protocol/blob/main/mcp_advanced_lab/mcp_http_server.py"
click node_http_client_base "https://github.com/khubaib-96/model-context-protocol/blob/main/mcp_advanced_lab/mcp_http_client_base.py"
click node_http_client_app "https://github.com/khubaib-96/model-context-protocol/blob/main/mcp_advanced_lab/mcp_http_client_app.py"
click node_http_host_app "https://github.com/khubaib-96/model-context-protocol/blob/main/mcp_advanced_lab/mcp_http_host_app.py"
click node_permission_server "https://github.com/khubaib-96/model-context-protocol/blob/main/mcp_security_lab/mcp_permission_server.py"
click node_permission_client_base "https://github.com/khubaib-96/model-context-protocol/blob/main/mcp_security_lab/mcp_permission_client_base.py"
click node_permission_client_app "https://github.com/khubaib-96/model-context-protocol/blob/main/mcp_security_lab/mcp_permission_client_app.py"
click node_permission_host_app "https://github.com/khubaib-96/model-context-protocol/blob/main/mcp_security_lab/mcp_permission_host_app.py"
click node_permission_store "https://github.com/khubaib-96/model-context-protocol/blob/main/mcp_security_lab/data/permissions.json"

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_basic,node_enhanced_server,node_enhanced_client,node_client_lab_client,node_client_lab_server toneBlue
class node_interaction_host,node_interaction_planner,node_interaction_agent,node_interaction_client,node_interaction_server toneAmber
class node_http_server,node_http_client_base,node_http_client_app,node_http_host_app toneMint
class node_permission_server,node_permission_client_base,node_permission_client_app,node_permission_host_app,node_permission_store toneRose
class node_user toneIndigo
```

## Components

### Core MCP Examples

- [Starter Example](https://github.com/khubaib-96/model-context-protocol/blob/main/basic_MCP.py): `basic_MCP.py`
- [File Operations Server](https://github.com/khubaib-96/model-context-protocol/blob/main/enhanced_MCP_server/server.py): `enhanced_MCP_server/server.py`
- [Enhanced Client](https://github.com/khubaib-96/model-context-protocol/blob/main/enhanced_MCP_server/client.py): `enhanced_MCP_server/client.py`
- [STDIO Client](https://github.com/khubaib-96/model-context-protocol/blob/main/mcp_client_lab/mcp_client.py): `mcp_client_lab/mcp_client.py`
- [Client Lab Server](https://github.com/khubaib-96/model-context-protocol/blob/main/mcp_client_lab/mcp_server.py): `mcp_client_lab/mcp_server.py`

### Agent Interactions

- [Request Host](https://github.com/khubaib-96/model-context-protocol/blob/main/MCP_interactions/host.py): `MCP_interactions/host.py`
- [Capability Planner](https://github.com/khubaib-96/model-context-protocol/blob/main/MCP_interactions/planner.py): `MCP_interactions/planner.py`
- [Tool Agent](https://github.com/khubaib-96/model-context-protocol/blob/main/MCP_interactions/agent.py): `MCP_interactions/agent.py`
- [MCP Session Client](https://github.com/khubaib-96/model-context-protocol/blob/main/MCP_interactions/mcp_client.py): `MCP_interactions/mcp_client.py`
- [Native MCP Server](https://github.com/khubaib-96/model-context-protocol/blob/main/MCP_interactions/server.py): `MCP_interactions/server.py`

### HTTP Labs

- [HTTP Server](https://github.com/khubaib-96/model-context-protocol/blob/main/mcp_advanced_lab/mcp_http_server.py): `mcp_advanced_lab/mcp_http_server.py`
- [HTTP Protocol Client](https://github.com/khubaib-96/model-context-protocol/blob/main/mcp_advanced_lab/mcp_http_client_base.py): `mcp_advanced_lab/mcp_http_client_base.py`
- [HTTP Client App](https://github.com/khubaib-96/model-context-protocol/blob/main/mcp_advanced_lab/mcp_http_client_app.py): `mcp_advanced_lab/mcp_http_client_app.py`
- [LLM HTTP Host](https://github.com/khubaib-96/model-context-protocol/blob/main/mcp_advanced_lab/mcp_http_host_app.py): `mcp_advanced_lab/mcp_http_host_app.py`

### Security Lab

- [Permission Server](https://github.com/khubaib-96/model-context-protocol/blob/main/mcp_security_lab/mcp_permission_server.py): `mcp_security_lab/mcp_permission_server.py`
- [Permission Client](https://github.com/khubaib-96/model-context-protocol/blob/main/mcp_security_lab/mcp_permission_client_base.py): `mcp_security_lab/mcp_permission_client_base.py`
- [Permission Client App](https://github.com/khubaib-96/model-context-protocol/blob/main/mcp_security_lab/mcp_permission_client_app.py): `mcp_security_lab/mcp_permission_client_app.py`
- [Permission LLM Host](https://github.com/khubaib-96/model-context-protocol/blob/main/mcp_security_lab/mcp_permission_host_app.py): `mcp_security_lab/mcp_permission_host_app.py`
- [Policy and Audit Files](https://github.com/khubaib-96/model-context-protocol/blob/main/mcp_security_lab/data/permissions.json): `mcp_security_lab/data/permissions.json`

### Other components

- **Learner**

## Connections

- Learner → Starter Example: runs example (evidence: `README.md`)
- Learner → File Operations Server: starts server (evidence: `README.md`)
- Learner → STDIO Client: connects client (evidence: `README.md`)
- Learner → Request Host: sends request (evidence: `README.md`)
- Request Host → Capability Planner: plans route (evidence: `MCP_interactions/host.py`)
- Request Host → Tool Agent: invokes agent (evidence: `MCP_interactions/host.py`)
- Request Host → MCP Session Client: opens session (evidence: `MCP_interactions/host.py`)
- Learner → HTTP Client App: uses HTTP lab (evidence: `README.md`)
- Learner → LLM HTTP Host: requests agent (evidence: `README.md`)
- HTTP Client App → HTTP Protocol Client: extends client (evidence: `mcp_advanced_lab/mcp_http_client_app.py`)
- LLM HTTP Host → HTTP Protocol Client: extends client (evidence: `mcp_advanced_lab/mcp_http_host_app.py`)
- Learner → Permission Client App: uses security lab (evidence: `README.md`)
- Learner → Permission LLM Host: requests protected tools (evidence: `README.md`)
- Permission Client App → Permission Client: uses permission client (evidence: `mcp_security_lab/mcp_permission_client_app.py`)
- Permission LLM Host → Permission Client: uses permission client (evidence: `mcp_security_lab/mcp_permission_host_app.py`)
- Permission Client → Policy and Audit Files: loads policy (evidence: `mcp_security_lab/mcp_permission_client_base.py`)
- Permission Client → Policy and Audit Files: writes audit log (evidence: `mcp_security_lab/mcp_permission_client_base.py`)
