Skip to content
Back to search

docker-mcp-tutorial

Complete tutorial materials for building MCP servers with Docker - from NetworkChuck's video

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/thenetworkchuck--docker-mcp-tutorial/badge.svg)](/listings/thenetworkchuck--docker-mcp-tutorial)

HTML

<a href="/listings/thenetworkchuck--docker-mcp-tutorial"><img src="/api/listings/thenetworkchuck--docker-mcp-tutorial/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.

Get your first MCP server running in under 5 minutes:

# 1. Install Docker Desktop (if not already installed)
# Visit: https://docs.docker.com/desktop/

# 2. Enable Docker MCP Toolkit
# Settings → Beta Features → Enable "Docker MCP Toolkit"

# 3. Clone this repository
git clone https://github.com/networkchuck/docker-mcp-tutorial.git
cd docker-mcp-tutorial

# 4. Build the dice roller example
cd examples/dice-roller
docker build -t dice-mcp-server .

# 5. Follow the Quick Start Guide
# See: quick-start/setup-guide.md

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 · 224 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # 🚀 Docker MCP Tutorial - Build AI Tools with Docker
  2. [![NetworkChuck](https://img.shields.io/badge/NetworkChuck-YouTube-red)](https://youtube.com/@NetworkChuck)
  3. [![Docker](https://img.shields.io/badge/Docker-Desktop-blue)](https://www.docker.com/products/docker-desktop/)
  4. [![MCP](https://img.shields.io/badge/MCP-Protocol-green)](https://modelcontextprotocol.io/)
  5. Learn how to build and deploy MCP (Model Context Protocol) servers using Docker! This repository contains everything from the NetworkChuck Docker MCP video tutorial, including complete examples, templates, and step-by-step guides.
  6. ## 🎥 Watch the Tutorial
  7. [**Watch the full video tutorial on YouTube →**](https://youtube.com/@NetworkChuck)
  8. ## ⚡ Quick Start (5 Minutes)
  9. Get your first MCP server running in under 5 minutes:
  10. ```bash
  11. # 1. Install Docker Desktop (if not already installed)
  12. # Visit: https://docs.docker.com/desktop/
  13. # 2. Enable Docker MCP Toolkit
  14. # Settings → Beta Features → Enable "Docker MCP Toolkit"
  15. # 3. Clone this repository
  16. git clone https://github.com/networkchuck/docker-mcp-tutorial.git
  17. cd docker-mcp-tutorial
  18. # 4. Build the dice roller example
  19. cd examples/dice-roller
  20. docker build -t dice-mcp-server .
  21. # 5. Follow the Quick Start Guide
  22. # See: quick-start/setup-guide.md
  23. ```
  24. ## 📚 What's Included
  25. ### 🎲 **Complete Working Example**
  26. - **Dice Roller** - Fun D&D dice rolling MCP server with all files ready to run
  27. ### 🛠️ **MCP Builder Prompt**
  28. NetworkChuck's custom prompt that generates complete MCP servers from simple descriptions. Just describe what you want, and it creates everything!
  29. ### 📖 **Comprehensive Documentation**
  30. - Step-by-step installation guides (Mac, Windows, Linux)
  31. - How to build custom MCP servers
  32. - Docker MCP Gateway deep dive
  33. - Troubleshooting common issues
  34. ### 🔗 **All Resources & Links**
  35. Every tool, link, and resource mentioned in the video, organized and ready to use.
  36. ## 🗂️ Repository Structure
  37. ```
  38. docker-mcp-tutorial/
  39. ├── examples/ # Complete working MCP server
  40. │ └── dice-roller/ # D&D dice rolling server
  41. ├── mcp-builder-prompt/ # AI prompt to generate MCP servers
  42. ├── quick-start/ # Get running in 5 minutes
  43. ├── docs/ # Detailed documentation
  44. │ ├── installation.md # Platform-specific setup
  45. │ ├── custom-servers.md # Build your own servers
  46. │ ├── docker-gateway.md # Gateway architecture
  47. │ └── troubleshooting.md # Common issues & fixes
  48. └── resources/ # Links and additional resources
  49. ```
  50. ## 🎯 What You'll Learn
  51. 1. **MCP Fundamentals** - Understand the Model Context Protocol
  52. 2. **Docker Integration** - Run MCP servers in containers
  53. 3. **Build Custom Servers** - Create your own AI tools
  54. 4. **API Integration** - Connect to external services
  55. 5. **Security & Secrets** - Manage API keys safely
  56. 6. **Remote Access** - Expose servers over network
  57. 7. **n8n Integration** - Automation workflows with MCP
  58. ## 🚦 Prerequisites
  59. - **Docker Desktop** installed and running
  60. - **Claude Desktop** or another MCP-compatible client
  61. - Basic command line knowledge
  62. - Coffee ☕ (highly recommended)
  63. ## 📋 Installation Overview
  64. ### 1. Install Docker Desktop
  65. - [Download Docker Desktop](https://www.docker.com/products/docker-desktop/)
  66. - Enable MCP Toolkit in Beta Features
  67. ### 2. Configure MCP Client
  68. - Set up Claude Desktop, Cursor, or LM Studio
  69. - Configure MCP gateway connection
  70. ### 3. Build & Deploy
  71. - Build Docker containers for MCP servers
  72. - Register servers in catalog
  73. - Start using with your AI!
  74. *Detailed platform-specific instructions in [docs/installation.md](docs/installation.md)*
  75. ## 🔨 Building Your First MCP Server
  76. ### Using the MCP Builder Prompt
  77. 1. Open the prompt template: `mcp-builder-prompt/mcp-builder-prompt.md`
  78. 2. Describe your desired functionality
  79. 3. Feed to Claude or your preferred AI
  80. 4. Get complete, working MCP server code!
  81. ### Example: Weather MCP Server
  82. ```
  83. "I want to build a weather MCP server that can:
  84. - Get current weather for any city
  85. - Get 5-day forecast
  86. - Convert between Celsius and Fahrenheit
  87. Use the OpenWeather API"
  88. ```
  89. The AI will generate all files needed: Dockerfile, Python server, configuration, and installation instructions!
  90. ## 🎮 Example Server Included
  91. ### 🎲 Dice Roller
  92. Perfect for D&D and tabletop gaming:
  93. - Roll any dice notation (2d6+3, 1d20, etc.)
  94. - D&D stat generation
  95. - Advantage/disadvantage rolls
  96. - Skill checks against DC
  97. **Note:** The video also demonstrates building Toggl Timer and Kali Linux MCP servers. Use the MCP Builder Prompt to create these or any other server you can imagine!
  98. ## 🔧 Docker MCP Gateway
  99. The Docker MCP Gateway is the magic that makes this all work:
  100. - **Centralized Management** - One connection, multiple servers
  101. - **Secret Management** - Secure API key storage
  102. - **Transport Options** - Local (stdio) or Network (SSE)
  103. - **Dynamic Containers** - Servers run on-demand
  104. Learn more in [docs/docker-gateway.md](docs/docker-gateway.md)
  105. ## 🌐 Remote Access & n8n Integration
  106. Run your MCP servers over the network:
  107. ```bash
  108. # Start gateway with network transport
  109. docker mcp gateway run --transport sse
  110. # Access from n8n or remote clients
  111. http://YOUR_IP:8811
  112. ```
  113. Perfect for automation workflows and remote AI operations!
  114. ## 🐛 Troubleshooting
  115. ### Common Issues
  116. **Tools not appearing in Claude?**
  117. - Restart Claude Desktop
  118. - Check catalog and registry files
  119. - Verify Docker image built successfully
  120. **Authentication errors?**
  121. - Verify secrets: `docker mcp secret list`
  122. - Check environment variable names
  123. **Container not running?**
  124. - Check logs: `docker logs [container-name]`
  125. - Verify Dockerfile syntax
  126. *Full troubleshooting guide in [docs/troubleshooting.md](docs/troubleshooting.md)*
  127. ## 📚 Resources & Links
  128. ### Official Documentation
  129. - [Docker Desktop](https://docs.docker.com/desktop/)
  130. - [Model Context Protocol](https://modelcontextprotocol.io/)
  131. - [Claude Desktop](https://claude.ai/download)
  132. ### APIs Used in Examples
  133. - [Toggl API Documentation](https://developers.toggl.com/docs/)
  134. - [Obsidian Local REST API](https://github.com/coddingtonbear/obsidian-local-rest-api)
  135. ### Related NetworkChuck Content
  136. - [n8n Automation Tutorial](https://youtube.com/@NetworkChuck)
  137. - [Docker Basics Series](https://youtube.com/@NetworkChuck)
  138. ## 🤝 Contributing
  139. Found a bug? Have an improvement? Contributions are welcome!
  140. 1. Fork the repository
  141. 2. Create your feature branch
  142. 3. Commit your changes
  143. 4. Push to the branch
  144. 5. Open a Pull Request
  145. ## 📄 License
  146. MIT License - See [LICENSE](LICENSE) file for details
  147. ## 🙏 Acknowledgments
  148. - **Docker** for sponsoring and creating the MCP Toolkit
  149. - **Anthropic** for the Model Context Protocol
  150. - The amazing **NetworkChuck community**
  151. ## ☕ Support
  152. If this helped you, consider:
  153. - ⭐ Starring this repository
  154. - 🔔 Subscribing to [NetworkChuck on YouTube](https://youtube.com/@NetworkChuck)
  155. - ☕ Buying NetworkChuck a coffee
  156. ---
  157. **Remember:** The world of AI tools is evolving rapidly. This is your chance to be part of the revolution. Don't waste it!
  158. *"Hack YouTube ethically, of course."* - NetworkChuck

Ratings and comments

Sign in to rate this skill.

Sign in

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