ProxMox VE脚本
ProxMox VE上MCP(模型上下文协议)服务器的自动部署脚本。
](https://github.com/notdabob/proxmox-ve-scripts)
______________________________________________________________________
🚀 即时部署(推荐)
使用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 部署什么
- 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上。
许可证
\[待添加许可证信息\]
