Docker MCP

🚀 Docker MCP 服务

Docker MCP 服务是一款强大的模型上下文协议服务器，可在 Docker 容器中执行代码，并将结果返回给 Claude 等语言模型（LLM）。它支持隔离的代码执行、多语言支持以及与各类包管理工具集成等多种功能，为开发者提供了高效、可靠的代码执行环境。

🚀 快速开始

启动 MCP 服务，只需执行以下命令：

python src/docker_mcp.py

启动后，访问 http://localhost:8090 即可打开 MCP 绑定的控制台。

✨ 主要特性

• 隔离的代码执行：借助 Docker 容器，确保代码在独立环境中运行，避免相互干扰。
• 多语言支持：支持 Python、Node.js 等多种编程语言，满足不同开发需求。
• 复杂脚本支持：能够处理复杂的脚本和任务，应对多样化的业务场景。
• 包管理：内置对 pip、npm、apt-get 和 apk 的支持，可自动检测并使用合适的包管理工具。
• 容器管理：提供创建、监控和清理 Docker 容器的功能，方便开发者进行容器操作。
• 健壮的错误处理：具备超时检测和恢复机制，确保任务可靠执行，提高系统稳定性。
• 彩色输出：通过终端颜色编码提升用户体验，使信息展示更加直观。

📦 安装指南

安装需求

• Python 版本要求：必须安装 Python 3.6 或更高版本。
• Docker 安装：请确保 Docker 已正确安装并运行（可通过 docker --version 命令验证）。
• fastmcp 库：需要安装 fastmcp 库以支持与 LLM 的集成。

安装步骤

1. 克隆代码仓库：

   git clone https://github.com/your-repository.git
   

2. 创建虚拟环境并激活：

   python -m venv venv
   source venv/bin/activate  # 在 Linux/Mac 上
   venv\Scripts\activate     # 在 Windows 上
   

3. 安装依赖项：

   pip install -r requirements.txt
   

💻 使用示例

基础用法

列出容器

查看所有运行中的 Docker 容器：

list_containers [--all]

• --all：显示所有容器，包括已停止的容器。

创建新容器

创建并启动一个新的 Docker 容器：

create_container [-i IMAGE] [-- privileged|nonPrivileged] [COMMAND]

• IMAGE：指定镜像，默认为 python:3.8-slim。
• privileged 或 nonPrivileged：设置容器的权限模式。
• COMMAND：指定要执行的命令。

执行命令

在现有容器中执行命令：

execute_command [-c CONTAINER_ID] [-t COMMAND]

• CONTAINER_ID：指定目标容器的 ID。
• COMMAND：要执行的具体命令。

删除容器

删除指定的 Docker 容器：

remove_container [-c CONTAINER_ID] [--volumes]

• CONTAINER_ID：指定要删除的容器 ID。
• --volumes：同时删除与容器关联的卷。

高级用法

基本工作流程示例

1. 列出所有容器：

   list_containers
   

2. 创建一个 Python 容器并执行命令：

   create_container -i python:3.8-slim -c "echo 'Hello, Docker!'" --nonPrivileged
   

3. 执行完成后，删除容器：

   remove_container [-c CONTAINER_ID]
   

Python 数据分析示例

1. 创建一个 Node.js 容器并安装依赖项：

   create_container -i node:16 --privileged npm install express axios
   

2. 执行脚本：

   execute_command [-c CONTAINER_ID] node script.js
   

📚 详细文档

包管理器支持

服务自动检测并使用适合的包管理工具：

• Python：使用 pip。
• Node.js：使用 npm。
• Debian/Ubuntu：使用 apt-get。
• Alpine：使用 apk。

对于无法从镜像名称推断包管理器的情况，系统会尝试检测可用的包管理工具。

与 LLM 的集成

通过 fastmcp 库支持与 Claude 等语言模型的集成，实现更高级的功能扩展。

⚠️ 注意事项

⚠️ 重要提示

• 运行 Docker 命令可能需要管理员权限，请确保以管理员身份执行相关操作。
• 请注意容器对 CPU 和内存的占用，避免过度使用系统资源，影响系统性能。
• 确保处理所有可能的异常情况，如网络中断或镜像未找到，以保证系统的稳定性。

🤝 贡献指南

欢迎参与项目开发！请参考项目的贡献指南以获取更多信息。