Docker MCP教程

学习如何使用Docker构建和部署MCP(Model Context Protocol)服务器,包含完整示例、模板和逐步指南。

  • by rarriagao
  • 本地部署
  • 更新于
在 GitHub 查看 rarriagao/Mcp-script

使用说明

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

学习如何使用Docker构建和部署MCP(模型上下文协议)服务器!此存储库包含NetworkChuck Docker MCP视频教程中的所有内容,包括完整的示例、模板和分步指南。

🎥 观看教程

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

⚡ 快速入门(5分钟)

让您的第一台MCP服务器在5分钟内运行:

# 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

📚 包含什么

🎲 完整工作示例

  • 摇骰子 -有趣的D&D骰子滚动MCP服务器,所有文件都已准备好运行

🛠️ MCP生成器提示

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基础 -了解模型上下文协议
  2. Docker集成 -在容器中运行MCP服务器
  3. 构建自定义服务器 -创建自己的AI工具
  4. API集成 -连接到外部服务
  5. 安全与秘密 -安全管理API密钥
  6. 远程访问 -通过网络公开服务器
  7. n8n集成 -使用MCP的自动化工作流程

🚦 先决条件

  • Docker桌面 已安装并正在运行
  • 克劳德桌面 或另一个MCP兼容客户端
  • 基本的命令行知识
  • 咖啡☕ (强烈推荐)

📋 安装概述

1.安装Docker桌面

2.配置MCP客户端

  • 设置Claude桌面、光标或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服务器、配置和安装说明!

🎮 示例服务器包括

🎲 摇骰子

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

  • 掷任意骰子符号(2d6+3、1d20等)
  • D&D统计数据生成
  • 优势/劣势辊
  • 针对DC的技能检查

注: 该视频还演示了如何构建Toggl Timer和Kali Linux MCP服务器。使用MCP Builder Prompt创建这些服务器或您可以想象的任何其他服务器!

🔧 Docker MCP网关

Docker MCP网关是实现这一切的神奇之处:

  • 集中管理 -一个连接,多个服务器
  • 秘密管理 -安全的API密钥存储
  • 运输选项 -本地(stdio)或网络(SSE)
  • 动态容器 -服务器按需运行

在中了解更多信息 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

非常适合自动化工作流程和远程人工智能操作!

🐛 故障排除

常见问题

克劳德没有出现工具?

  • 重新启动克劳德桌面
  • 检查目录和注册表文件
  • 验证Docker镜像构建成功

身份验证错误?

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

集装箱未运行?

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

中的完整故障排除指南 docs/故障排除.md

📚 资源和链接

官方文件

示例中使用的API

相关网络Chuck内容

🤝 贡献

发现bug了吗?有改善吗?欢迎投稿!

  1. 分叉存储库
  2. 创建功能分支
  3. 提交您的更改
  4. 推到分支
  5. 打开拉取请求

📄 许可证

MIT许可证-请参阅 许可证 详细信息文件

🙏 致谢

  • 码头工人 用于赞助和创建MCP工具包
  • Anthropic 对于模型上下文协议
  • 令人惊叹的 网络Chuck社区

☕ 支持

如果这对你有帮助,请考虑:


记得: 人工智能工具的世界正在迅速发展。这是你参与革命的机会。别浪费了!

“当然,以道德的方式攻击YouTube。” -网络Chuck