Proxmox VE的MCP服务器
A. 模型上下文协议(MCP)服务器 为了 Proxmox虚拟环境 它使AI助手能够通过自然语言交互来管理虚拟机、容器、节点和资源。
🚀 特性
- 节点管理:列出并监视Proxmox群集节点
- VM操作:启动、停止和监视虚拟机
- 容器管理:管理LXC容器
- 状态监测:节点、虚拟机和容器的实时状态信息
- 安全认证:同时支持密码和API令牌身份验证
- 多节点支持:适用于单节点或完整的Proxmox集群
📋 先决条件
- Node.js 18.0.0或更高版本
- 具有API访问权限的Proxmox VE 7.0+
- 有效的Proxmox凭据(用户名/密码或API令牌)
🛠️ 安装
来源```bash
git clone https://github.com/heybearc/mcp-server-proxmox.git
cd mcp-server-proxmox
npm install
npm run build
### 来自NPM(即将推出)```bash
npm install -g mcp-server-proxmox
⚙️ 配置
环境变量
创建一个 .env 文件或设置以下环境变量:```bash
Proxmox Server Configuration
PROXMOX_HOST=your-proxmox-host.com
PROXMOX_PORT=8006
PROXMOX_USERNAME=root
PROXMOX_REALM=pam
Authentication Method 1: Password
PROXMOX_PASSWORD=your-password
Authentication Method 2: API Token (Recommended)
PROXMOX_TOKEN=your-api-token
PROXMOX_TOKEN_NAME=your-token-name
SSL Configuration
PROXMOX_VERIFY_SSL=true
### MCP客户端配置
#### 克劳德桌面
添加到您的 `claude_desktop_config.json`:```json
{
"mcpServers": {
"proxmox": {
"command": "node",
"args": ["/path/to/mcp-server-proxmox/dist/index.js"],
"env": {
"PROXMOX_HOST": "your-proxmox-host.com",
"PROXMOX_USERNAME": "root",
"PROXMOX_TOKEN": "your-api-token",
"PROXMOX_TOKEN_NAME": "your-token-name"
}
}
}
}
其他MCP客户端
有关服务器配置,请参阅MCP客户端的文档。
🔧 可用工具
| 工具 | 说明 | 参数 |
|---|---|---|
list_nodes |
列出所有Proxmox节点 | 无 |
list_vms |
列出虚拟机 | node (可选) |
list_containers |
列出LXC容器 | node (可选) |
get_vm_status |
获取VM状态详细信息 | node, vmid |
start_vm |
启动虚拟机 | node, vmid |
stop_vm |
停止虚拟机 | node, vmid |
get_node_status |
获取节点状态详细信息 | node |
💡 使用示例
使用AI助手```
"Show me all VMs on my Proxmox cluster"
"Start VM 100 on node pve1"
"What's the status of my Proxmox nodes?"
"List all containers on node pve2"
### API直接使用```bash
# Start the server
npm start
# The server communicates via stdio using MCP protocol
🔐 安全
API令牌设置(推荐)
- 登录Proxmox web界面
- 首选 数据中心 → 权限 → API令牌
- 创建具有适当权限的新令牌
- 在配置中使用令牌
必需的权限
VM.Audit-查看VM信息VM.PowerMgmt-启动/停止虚拟机Sys.Audit-查看节点信息Datastore.Audit-查看存储信息
🧪 发展```bash
Install dependencies
npm install
Run in development mode
npm run dev
Build for production
npm run build
Run tests
npm test
Lint code
npm run lint
Format code
npm run format
```
🤝 贡献
欢迎投稿!请看 贡献.md 作为指导方针。
📄 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
🔗 相关项目
- 模型上下文协议
- MCP TypeScript SDK
- Proxmox VE API文档
📞 支持
- 🐛 报告问题
- 💬 讨论
- 📧 联系
