🚀 Docker MCP 教程 - 使用 Docker 构建 AI 工具

学习如何使用 Docker 构建和部署 MCP（模型上下文协议）服务器！本仓库包含了 NetworkChuck Docker MCP 视频教程的所有内容，包括完整示例、模板和分步指南。

🎥 观看教程

在 YouTube 上观看完整视频教程 →

⚡ 快速开始 (5 分钟)

在 5 分钟内运行你的第一个 MCP 服务器：

# 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

📚 包含内容

🎲 完整工作示例

• 骰子投掷器 (Dice Roller) - 有趣的 D&D（龙与地下城）骰子投掷 MCP 服务器，所有文件均已就绪可直接运行

🛠️ MCP 构建器提示词 (MCP Builder Prompt)

NetworkChuck 的自定义提示词，可根据简单描述生成完整的 MCP 服务器。只需描述你想要的功能，它就会创建所有内容！

📖 综合文档

• 分步安装指南（Mac、Windows、Linux）
• 如何构建自定义 MCP 服务器
• Docker MCP 网关深度解析
• 常见问题的故障排除

🔗 所有资源与链接

视频中提到的每个工具、链接和资源，均已整理好可供直接使用。

🗂️ 仓库结构

docker-mcp-tutorial/
├── examples/                    # Complete working MCP server
│   └── dice-roller/            # D&D dice rolling server
├── mcp-builder-prompt/         # AI prompt to generate MCP servers
├── quick-start/               # Get running in 5 minutes
├── docs/                      # Detailed documentation
│   ├── installation.md       # Platform-specific setup
│   ├── custom-servers.md     # Build your own servers
│   ├── docker-gateway.md     # Gateway architecture
│   └── troubleshooting.md    # Common issues & fixes
└── resources/                 # Links and additional resources

🎯 你将学到什么

1. MCP 基础 (MCP Fundamentals) - 理解模型上下文协议
2. Docker 集成 (Docker Integration) - 在容器中运行 MCP 服务器
3. 构建自定义服务器 (Build Custom Servers) - 创建你自己的 AI 工具
4. API 集成 (API Integration) - 连接外部服务
5. 安全与密钥 (Security & Secrets) - 安全地管理 API 密钥
6. 远程访问 (Remote Access) - 在网络中暴露服务器
7. n8n 集成 (n8n Integration) - 使用 MCP 进行自动化工作流

🚦 前置条件

• 已安装并正在运行的 Docker Desktop
• Claude Desktop 或其他兼容 MCP 的客户端
• 基本的命令行知识
• 咖啡 ☕（强烈推荐）

📋 安装概览

1. 安装 Docker Desktop

• 下载 Docker Desktop
• 在 Beta Features 中启用 MCP Toolkit

2. 配置 MCP 客户端

• 设置 Claude Desktop、Cursor 或 LM Studio
• 配置 MCP 网关连接

3. 构建与部署

• 为 MCP 服务器构建 Docker 容器
• 在目录中注册服务器
• 开始在你的 AI 中使用！

详细的平台特定说明请查看 docs/installation.md

🔨 构建你的第一个 MCP 服务器

使用 MCP 构建器提示词

1. 打开提示词模板：mcp-builder-prompt/mcp-builder-prompt.md
2. 描述你所需的功能
3. 发送给 Claude 或你喜欢的 AI
4. 获取完整可用的 MCP 服务器代码！

示例：天气 MCP 服务器

"I want to build a weather MCP server that can:
- Get current weather for any city
- Get 5-day forecast
- Convert between Celsius and Fahrenheit
Use the OpenWeather API"

AI 将生成所有必要的文件：Dockerfile、Python 服务器、配置和安装说明！

🎮 包含示例服务器

🎲 骰子投掷器 (Dice Roller)

非常适合 D&D 和桌面游戏：

• 投掷任何骰子表示法（2d6+3, 1d20 等）
• D&D 属性生成
• 优势/劣势投掷 (Advantage/disadvantage rolls)
• 对抗 DC 的技能检定 (Skill checks against DC)

注意： 视频还演示了构建 Toggl 计时器和 Kali Linux MCP 服务器。使用 MCP 构建器提示词来创建这些或任何其他你能想到的服务器！

🔧 Docker MCP 网关

Docker MCP 网关是让这一切生效的关键魔法：

• 集中管理 (Centralized Management) - 一个连接，多个服务器
• 密钥管理 (Secret Management) - 安全的 API 密钥存储
• 传输选项 (Transport Options) - 本地 (stdio) 或网络 (SSE)
• 动态容器 (Dynamic Containers) - 按需运行服务器

更多信息请查看 docs/docker-gateway.md

🌐 远程访问与 n8n 集成

通过网络运行你的 MCP 服务器：

# Start gateway with network transport
docker mcp gateway run --transport sse

# Access from n8n or remote clients
http://YOUR_IP:8811

非常适合自动化工作流和远程 AI 操作！

🐛 故障排除

常见问题

Claude 中未显示工具？

• 重启 Claude Desktop
• 检查目录和注册表文件
• 验证 Docker 镜像是否构建成功

认证错误？

• 验证密钥：docker mcp secret list
• 检查环境变量名称

容器未运行？

• 检查日志：docker logs [container-name]
• 验证 Dockerfile 语法

完整故障排除指南请查看 docs/troubleshooting.md

📚 资源与链接

官方文档

• Docker Desktop
• 模型上下文协议 (Model Context Protocol)
• Claude Desktop

示例中使用的 API

• Toggl API 文档
• Obsidian 本地 REST API

相关 NetworkChuck 内容

• n8n 自动化教程
• Docker 基础系列

🤝 贡献

发现 Bug 了吗？有改进建议吗？欢迎贡献！

1. Fork 仓库
2. 创建你的特性分支
3. 提交你的更改
4. 推送到分支
5. 发起 Pull Request

📄 许可证

MIT 许可证 - 详见 LICENSE 文件

🙏 致谢

• Docker 赞助并创建了 MCP 工具包
• Anthropic 提供了模型上下文协议
• 令人惊叹的 NetworkChuck 社区

☕ 支持

如果这对你有帮助，请考虑：

• ⭐ 星标此仓库
• 🔔 订阅 YouTube 上的 NetworkChuck
• ☕ 请 NetworkChuck 喝杯咖啡

---

记住： AI 工具的世界正在迅速演变。这是你参与这场革命的机会。别浪费了！

“当然，要合乎道德地 Hack YouTube。” - NetworkChuck

docker-mcp-tutorial 快速上手指南

本工具旨在帮助用户通过 Docker 快速构建和部署 MCP (Model Context Protocol) 服务器。仓库包含完整的示例（如骰子投掷器）、AI 生成提示词及详细文档，助你在 5 分钟内运行第一个 MCP 服务。

1. 环境准备

在开始之前，请确保你的开发环境满足以下要求：

• 操作系统：macOS, Windows 或 Linux
• 核心依赖：
  • Docker Desktop 已安装并运行
  • Git 已安装
• MCP 客户端：
  • 支持 MCP 协议的客户端（如 Claude Desktop, Cursor, LM Studio 等）
• 网络环境：
  • 能够访问 GitHub 和 Docker Hub（国内用户建议使用稳定代理或镜像源）

注意：需要在 Docker Desktop 中启用 MCP 功能。 路径：Settings → Beta Features → Enable "Docker MCP Toolkit"

2. 安装步骤

按照以下步骤克隆仓库并构建第一个示例服务器：

1. 克隆仓库

   git clone https://github.com/networkchuck/docker-mcp-tutorial.git
   cd docker-mcp-tutorial
   

2. 构建示例镜像 进入 Dice Roller 示例目录并构建 Docker 镜像：

   cd examples/dice-roller
   docker build -t dice-mcp-server .
   

3. 配置 MCP 客户端 参考 quick-start/setup-guide.md 将构建好的服务器注册到你的 MCP 客户端配置中。

3. 基本使用

构建完成后，你可以通过以下方式启动和使用 MCP 服务器：

本地运行与连接

默认情况下，MCP 客户端会通过标准输入/输出（stdio）或直接连接方式与容器通信。确保你的 MCP 客户端（如 Claude Desktop）的配置文件指向了正确的 MCP 网关地址。

启动 MCP 网关 (远程/网络访问)

如果你需要通过网络访问或在 n8n 等自动化工具中使用，可以启动 Docker MCP Gateway：

# 启动网关并启用 SSE 传输协议
docker mcp gateway run --transport sse

# 此时可通过以下地址访问
http://YOUR_IP:8811

使用 MCP Builder Prompt

除了手动编写代码，你还可以利用仓库中的 mcp-builder-prompt 让 AI 自动生成 MCP 服务器代码：

1. 打开 mcp-builder-prompt/mcp-builder-prompt.md
2. 描述你的需求（例如："I want to build a weather MCP server..."）
3. 将描述发送给 AI，获取完整的 Dockerfile 和服务器代码

---

更多详细文档（安装指南、自定义服务器构建、故障排查）请参阅仓库内的 docs/ 目录。