使用说明
ProxMox VE脚本
ProxMox VE上MCP（模型上下文协议）服务器的自动部署脚本。
🚀 即时部署（推荐）
使用MCP服务器创建Docker VM的一个命令：
git clone https://github.com/notdabob/proxmox-ve-scripts.git && cd proxmox-ve-scripts && chmod +x scripts/*.sh && ./scripts/one-liner-deploy.sh
这使用行业标准 ProxmoxVE社区脚本 致：
- ✅ 使用预装的Docker创建Debian 12虚拟机
- ✅ 自动配置网络和存储
- ✅ 部署MCP服务器（Context7、桌面命令器、文件系统）
- ✅ 设置管理命令
替代方法
方法1：使用Portainer完成Docker虚拟机
./scripts/proxmox_docker_vm_complete.sh
这种替代方法提供了：
- 交互式配置向导
- 预装Docker CE的Debian 12
- 集装箱管理门户
- 自动QEMU来宾代理设置
- 自定义磁盘大小选项
方法2：仅创建虚拟机（ProxmoxVE社区脚本）
VMID=210 HOSTNAME=mcp-docker CORE=4 MEMORY=4096 DISK=40 \
bash -c "$(wget -qLO - https://github.com/community-scripts/ProxmoxVE/raw/main/vm/docker-vm.sh)"
然后分别部署MCP服务器。
方法3：循序渐进
# 1. Create Docker VM
./scripts/create_mcp_docker_vm.sh
# 2. Deploy MCP servers (after VM boots)
./scripts/deploy_mcp_to_docker_vm.sh <VM_IP>
部署什么
- Debian 12虚拟机 预装Docker CE
- MCP服务器 （通过docker compose.yaml）：
- Context7 MCP（端口7001）-SQLite上下文管理
- 桌面指挥官（端口7002）-系统控制能力
- 文件系统MCP（端口7003）-文件系统访问
- 管理工具:
mcp易于控制的命令 - Docker Compose：所有服务的声明性配置
客户端配置
部署后，配置您的AI客户端（Claude Desktop等）：
python3 scripts/mcp_client_autoconfig.py
这将自动检测MCP服务器并配置您的客户端。
特性
- 行业标准基地 -使用经过验证的ProxmoxVE社区脚本
- 自动VM创建 -预装Docker CE的Debian 12虚拟机
- MCP服务器套件 -Context7、Desktop Commander和文件系统MCP服务器
- Docker编写配置 -带有健康检查的声明性服务定义
- 零手动配置 -完全自动化的部署过程
- 客户端自动配置 -发现并配置克劳德桌面、困惑等。
- 管理工具 -内置
mcp便于服务器控制的命令
文档
- 项目结构：参见
docs/file-structure.md用于可视化项目布局 - 详细指南：参见
CLAUDE.md用于全面的文档记录 - 版本历史记录：参见
docs/CHANGELOG.md用于发布说明 - Jupyter笔记本：参见
docs/README.ipynb用于交互式示例和教程
Jupyter笔记本
- 当你想要一个新的交互式教程或代码演练时，用一个明确的请求提示Claude code，例如：
- “创建一个Jupyter笔记本，演示如何使用此项目中的脚本部署MCP服务器
- 带有分步说明和可运行的代码单元。”
需求
- ProxMox VE主机，带互联网连接
- 带请求库的Python 3（用于客户端配置）
- 客户端和MCP VM之间的网络连接
安全说明
默认VM凭据： root:proxmox - 部署后立即更改这些！
贡献
欢迎投稿！请随时提交拉取请求。
支持
如果您遇到任何问题或有疑问，请 打开一个问题 在GitHub上。
许可证
[待添加许可证信息]
