Skip to content
Back to search

mcp-server-workshop-2026

Build Your Own MCP Server and Develop AI Agents from Scratch

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mcollignon989-afk--mcp-server-workshop-2026/badge.svg)](/listings/mcollignon989-afk--mcp-server-workshop-2026)

HTML

<a href="/listings/mcollignon989-afk--mcp-server-workshop-2026"><img src="/api/listings/mcollignon989-afk--mcp-server-workshop-2026/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

# 1. Clone the repository
git clone https://github.com/choas/mcp-workshop-2026-11-20.git
cd mcp-workshop-2026-11-20/Code

# 2. Start the Notes App (Step 01)
cd step-01-notes-app
npm install
npm run dev

# 3. Open in browser
open http://localhost:3001

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 131 lines
  1. # Build Your Own MCP Server and Develop AI Agents from Scratch
  2. **VibeKode Berlin 2026 Workshop**
  3. **Friday, November 20, 2026**
  4. Welcome! In this full-day hands-on workshop, you'll learn how to develop MCP (Model Context Protocol) servers and use them to build powerful AI agents.
  5. ## Quick Start
  6. ```bash
  7. # 1. Clone the repository
  8. git clone https://github.com/choas/mcp-workshop-2026-11-20.git
  9. cd mcp-workshop-2026-11-20/Code
  10. # 2. Start the Notes App (Step 01)
  11. cd step-01-notes-app
  12. npm install
  13. npm run dev
  14. # 3. Open in browser
  15. open http://localhost:3001
  16. ```
  17. ## Workshop Structure
  18. | Folder | Description |
  19. |--------|-------------|
  20. | `Code/step-01-notes-app/` | Notes REST API + WebUI (pre-built, trainer explains) |
  21. | `Code/step-02-notes-mcp/` | Notes MCP server (build incrementally) |
  22. | `Code/step-03-weather-mcp/` | Weather + geocoding MCP servers the LLM composes |
  23. | `Code/step-05-mcp-client/` | Own MCP client + tiny agent (appendix) |
  24. | `Code/step-06-notes-mcp-v2/` | Notes server migrated to SDK v2 / spec 2026-07-28, stdio + stateless HTTP |
  25. | `Code/step-07-webmcp-agent/` | Notes app as a WebMCP page + its own agent for LM Studio, Ollama or OpenAI |
  26. ### Step 02 Incremental Phases
  27. ```
  28. step-02-notes-mcp/
  29. ├── phase-1-scaffold/ # Empty MCP server
  30. ├── phase-2-tools/ # Add CRUD tools
  31. ├── phase-3-resources/ # Add resources
  32. ├── phase-4-prompts/ # Add prompts
  33. └── complete/ # Full implementation
  34. ```
  35. ### Step 03 Phases
  36. ```
  37. step-03-weather-mcp/
  38. ├── phase-1-weather/ # weather-mcp (Open-Meteo, needs coordinates)
  39. └── phase-2-geocoding/ # geocoding-mcp (Nominatim, place name -> coordinates)
  40. ```
  41. ## Workshop Flow
  42. 1. **Opening Demo** - See all MCP servers in action
  43. 2. **Step 01** - Explore the Notes App (API + WebUI)
  44. 3. **Step 02** - Build MCP server incrementally (tools -> resources -> prompts)
  45. 4. **Step 03** - Wrap external APIs with MCP and compose two servers (weather + geocoding)
  46. 5. **Integration** - Connect servers to LLM clients + explore community MCP servers
  47. 6. **Agents** - Put the tools in a loop to build an autonomous agent
  48. 7. **Security** - Defend the agent (lethal trifecta, human-in-the-loop) before shipping
  49. 8. **MCP v2** - What spec 2026-07-28 changed and why; migrate the Notes server to SDK v2
  50. 9. **Production** - Tool design, context cost, auth, gateways, evals; capstone on a real use case
  51. ### What changed since the June 2026 run
  52. - New Block 7 (MCP v2) and Block 8 (production patterns + capstone) raise the level in the afternoon
  53. - "Two speeds": experienced participants can fast-track Blocks 2-3
  54. - [use-cases.md](use-cases.md): MCP use cases with risk notes, input for the capstone
  55. - SSE transport replaced by Streamable HTTP; model IDs updated
  56. ## Prerequisites
  57. - Node.js 22+ and npm 10+ (Node 22 is required for the built-in `node:sqlite` module)
  58. - Access to an LLM with tool calling (Claude, GPT, Gemini, or a local model) and an
  59. MCP host (Claude Desktop, VS Code, ...). Bring your own; there is no shared gateway
  60. - Git
  61. - Code editor (VS Code recommended)
  62. - Curiosity!
  63. ## Useful Commands
  64. ### MCP Inspector (test without LLM)
  65. ```bash
  66. cd Code/step-02-notes-mcp/phase-2-tools
  67. npm install
  68. npx @modelcontextprotocol/inspector npx tsx src/index.ts
  69. ```
  70. ### Reset Database
  71. All steps share the database of the Notes App:
  72. ```bash
  73. cd Code/step-01-notes-app
  74. rm data/notes.db
  75. npm run dev # Recreates automatically
  76. ```
  77. ## Optional Add-Ons
  78. - [Build Your Own MCP Client](Presentation/appendix-mcp-client.md) — build the *other* half of
  79. the protocol; the clearest way to see how MCP works on the wire
  80. - [Extension Challenges](EXTENSION_CHALLENGES.md) — bonus exercises if you finish early
  81. - [Use Cases](use-cases.md) — what to build with MCP, and what to watch out for
  82. - [MCP v2 Clients](mcp-v2-clients.md) — which hosts and SDKs speak spec 2026-07-28
  83. ## Resources
  84. - [MCP Specification](https://modelcontextprotocol.io/specification)
  85. - [Spec 2026-07-28 release notes](https://blog.modelcontextprotocol.io/posts/2026-07-28/)
  86. - [TypeScript SDK v2 docs and migration](https://ts.sdk.modelcontextprotocol.io/v2/)
  87. - [VibeKode Conference](https://vibekode.it)
  88. - [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)
  89. - [Reference MCP Servers](https://github.com/modelcontextprotocol/servers)
  90. - [Awesome MCP Servers](https://github.com/wong2/awesome-mcp-servers)
  91. - [Try MCP in your browser](https://try-mcp.dev)
  92. ## Trainer
  93. **Lars Gregori**
  94. Senior AI Engineer, appliedAI Initiative GmbH
  95. - Blog: [larsgregori.de](https://larsgregori.de)
  96. - LinkedIn: [/in/larsgregori](https://linkedin.com/in/larsgregori)
  97. ---
  98. *Happy Vibe Coding!*

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.