How khubaib-96/model-context-protocol works
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: host.py Request Host · mcp_permission_client_base.py Permission Client · mcp_http_client_app.py HTTP Client App · mcp_http_host_app.py LLM HTTP Host
Components 20
Core MCP Examples
- Starter Example
basic_MCP.py - File Operations Server
enhanced_MCP_server/server.py - Enhanced Client
enhanced_MCP_server/client.py - STDIO Client
mcp_client_lab/mcp_client.py - Client Lab Server
mcp_client_lab/mcp_server.py
Agent Interactions
- Request Host
MCP_interactions/host.py - Capability Planner
MCP_interactions/planner.py - Tool Agent
MCP_interactions/agent.py - MCP Session Client
MCP_interactions/mcp_client.py - Native MCP Server
MCP_interactions/server.py
HTTP Labs
- HTTP Server
mcp_advanced_lab/mcp_http_server.py - HTTP Protocol Client
mcp_advanced_lab/mcp_http_client_base.py - HTTP Client App
mcp_advanced_lab/mcp_http_client_app.py - LLM HTTP Host
mcp_advanced_lab/mcp_http_host_app.py
Security Lab
- Permission Server
mcp_security_lab/mcp_permission_server.py - Permission Client
mcp_security_lab/mcp_permission_client_base.py - Permission Client App
mcp_security_lab/mcp_permission_client_app.py - Permission LLM Host
mcp_security_lab/mcp_permission_host_app.py - Policy and Audit Files
mcp_security_lab/data/permissions.json
Other components
- Learner
Connections 17
- Learner → Starter Example: runs example
README.md - Learner → File Operations Server: starts server
README.md - Learner → STDIO Client: connects client
README.md - Learner → Request Host: sends request
README.md - Request Host → Capability Planner: plans route
MCP_interactions/host.py - Request Host → Tool Agent: invokes agent
MCP_interactions/host.py - Request Host → MCP Session Client: opens session
MCP_interactions/host.py - Learner → HTTP Client App: uses HTTP lab
README.md - Learner → LLM HTTP Host: requests agent
README.md - HTTP Client App → HTTP Protocol Client: extends client
mcp_advanced_lab/mcp_http_client_app.py - LLM HTTP Host → HTTP Protocol Client: extends client
mcp_advanced_lab/mcp_http_host_app.py - Learner → Permission Client App: uses security lab
README.md - Learner → Permission LLM Host: requests protected tools
README.md - Permission Client App → Permission Client: uses permission client
mcp_security_lab/mcp_permission_client_app.py - Permission LLM Host → Permission Client: uses permission client
mcp_security_lab/mcp_permission_host_app.py - Permission Client → Policy and Audit Files: loads policy
mcp_security_lab/mcp_permission_client_base.py - Permission Client → Policy and Audit Files: writes audit log
mcp_security_lab/mcp_permission_client_base.py