What this is. A client-first, problem-driven path through the Cat Shop server. Instead of building the finished server bottom-up, you start with the smallest thing that works — one tool and a local client you write yourself — and add one capability per layer, each because you hit a wall the previous layer couldn't pass. Every layer ends with a command you run to validate it, and a diagram that grows as the system does.
Two editions, pick your style. This is the companion to
08_MCP_LEARNING_JOURNEY.md(the Build-From-Scratch edition, which reconstructs every server file top-to-bottom). They teach the
What this is. A guided, type-it-yourself rebuild of the Cat Shop MCP server. You will reconstruct the server one layer at a time, run a checkpoint after each layer, and answer a short understand-it question before moving on. By the end you'll be able to explain every file in
app/— and you'll be ready to add your own tool (the graded Activity).How to use it. The finished server already ships in
app/. So you have two ways to travel:
- Build mode (recommended): create a new package folder
catshop/next toapp/and type
What this is. A guided, type-it-yourself rebuild of the Cat Shop MCP server. You will reconstruct the server one layer at a time, run a checkpoint after each layer, and answer a short understand-it question before moving on. By the end you'll be able to explain every file in
app/— and you'll be ready to add your own tool (the graded Activity).How to use it. The finished server already ships in
app/. So you have two ways to travel:
- Build mode (recommended): create a new package folder
catshop/next toapp/and type
A frame to help you reason through the assignment — the concepts, diagrams, and API map. It deliberately does not contain the answers or a filled-in tool. Instead it gives you the questions to ask yourself and the method to get there. The work — and the learning — is in reading the server code, running it, connecting a client, and writing your own conclusions.
Source repo:
08_MCP/— entry pointserver.py, server packageapp/(server.py,tools.py,oauth.py,routes.py,db.py). There is no notebook this session — Q1/Q2 are answered inREADME.md, and your code deliverable is a new@mcp.tool()in
A frame to help you reason through the assignment — concepts, diagrams, and the API map. It deliberately does not contain the answers or filled-in activity code. Instead it gives you the questions to ask yourself and the method to get there. The work — and the learning — is in running the cells, inspecting both retriever result lists and reading the per-claim faithfulness verdicts, and writing your own conclusions.
Notebook:
01_Cat_Health_Advanced_Retrieval.ipynbCorpus:data/cat_health_guidelines.pdf(feline life-stage wellness guidelines — a retrieval
A frame to help you reason through the assignment — concepts, diagrams, and the API map. It deliberately does not contain the answers or filled-in activity code. Instead it gives you the questions to ask yourself and the method to get there. The work — and the learning — is in running the cells, reading a trace, and writing your own conclusions.
Notebook:
01_Metal_Price_Agent_Evaluation_Ragas_LangGraph.ipynbCorpus:data/HealthWellnessGuide.txt(educational wellness — not medical advice).
A frame to help you reason through the assignment — concepts, diagrams, and the API map. It deliberately does not contain the answers or filled-in activity code. Instead it gives you the questions to ask yourself and the method to get there. The work — and the learning — is in running the cells, reading a trace, and writing your own conclusions.
Notebook:
01_Metal_Price_Agent_Evaluation_Ragas_LangGraph.ipynbCorpus:data/HealthWellnessGuide.txt(educational wellness — not medical advice).
MCP (Model Context Protocol)
- MCP Official Docs — Spec, tutorials, and guides
- MCP-UI — Official standard for interactive UI in MCP
- MCP Auth Guide (Auth0) — Deep dive into MCP auth spec updates