Skip to content

Instantly share code, notes, and snippets.

@donbr
donbr / sess8-mcp-layered.md
Created June 26, 2026 03:10
Session 8 — MCP Learning Journey (Layered Edition)

Session 8 — MCP Learning Journey (Layered Edition): From One Tool to a Public OAuth Server

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

@donbr
donbr / sess8-mcp-code-from-scratch.md
Created June 26, 2026 01:22
Session 8 — MCP Learning Journey

Session 8 — MCP Learning Journey: Build the Cat Shop Server From Scratch

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 to app/ and type
@donbr
donbr / sess8-mcp-learning-journey.md
Created June 26, 2026 01:00
Session 8 — MCP Learning Journey

Session 8 — MCP Learning Journey: Build the Cat Shop Server From Scratch

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 to app/ and type
@donbr
donbr / sess8-cheat-sheet-mcp.md
Created June 25, 2026 23:36
Session 8 Cheat Sheet — Model Context Protocol (MCP)

Session 8 Cheat Sheet — Model Context Protocol (MCP)

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 point server.py, server package app/ (server.py, tools.py, oauth.py, routes.py, db.py). There is no notebook this session — Q1/Q2 are answered in README.md, and your code deliverable is a new @mcp.tool() in

@donbr
donbr / 07_Advanced_Retrievers_CHEATSHEET_STUDENT.md
Created June 23, 2026 23:44
07_Advanced_Retrievers_CHEATSHEET_STUDENT.md

Session 7 Cheat Sheet — Advanced Retrievers

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.ipynb Corpus: data/cat_health_guidelines.pdf (feline life-stage wellness guidelines — a retrieval

@donbr
donbr / 06_Agentic_RAG_Evaluation_CHEATSHEET_STUDENT.md
Created June 23, 2026 23:43
06_Agentic_RAG_Evaluation_CHEATSHEET_STUDENT.md

Session 6 Cheat Sheet — Agentic RAG Evaluation (Ragas + LangGraph)

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.ipynb Corpus: data/HealthWellnessGuide.txt (educational wellness — not medical advice).

@donbr
donbr / session6-agentic-rag-cheat-sheet.md
Created June 19, 2026 01:03
session6-agentic-rag-cheat-sheet

Session 6 Cheat Sheet — Agentic RAG Evaluation (Ragas + LangGraph)

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.ipynb Corpus: data/HealthWellnessGuide.txt (educational wellness — not medical advice).

@donbr
donbr / multi-agent-deep-research-abc.md
Last active June 12, 2026 00:50
session4-multi-agent-deep-research.md

Session 4 Slides — Multi-Agent Deep Research

Markdown slide spec. --- separates slides. Mermaid diagrams render concepts; speaker notes carry Socratic prompts. Teaching philosophy: concepts before code, no copy-paste solutions.


Slide 1 — Title

Multi-Agent Systems

@donbr
donbr / model-context-protocol-session.md
Created March 11, 2026 00:59
Model Context Protocol

Model Context Protocol


📚 Useful Resources

MCP (Model Context Protocol)

@donbr
donbr / ngrok-instructions.md
Created March 11, 2026 00:11
ngrok instructions

AGENTS.md

Subagent definitions for automating ngrok setup on Linux/WSL2. The MCP server needs ngrok to expose localhost:8000 publicly for Claude Desktop and remote clients.

ngrok-detect

Checks whether ngrok is installed and reports its path and version. Read-only — no side effects.

Instructions