内容
# proxmox-mcp
一款适用于Proxmox VE的MCP服务器，使用bun和@modelcontextprotocol/sdk构建。使用静态oauth详细信息进行身份验证。
## 安装配置
1. 克隆仓库
2. 使用`bun install`安装依赖项
3. 将`.env.example`复制到`.env`并填写所有值
4. 使用`bun .`运行服务器
5. 将`http://localhost:3000/mcp`（如果适用，请替换基准URL）添加到您选择的AI中（如下面的示例配置），以及oauth客户端ID和密钥。
6. AI现在应该能够向MCP服务器发送请求。
### 示例：Opencode
将mcp添加到您的opencode配置中，并运行`opencode mcp auth proxmox-mcp`登录。 \
示例opencode配置：
```json
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"proxmox-mcp": {
"type": "remote",
"url": "http://localhost:3000/mcp",
"enabled": true,
"oauth": {
"clientId": "请更换",
"clientSecret": "请更换"
}
}
}
}
```
### 示例：Claude（网页）
1. 导航到https://claude.ai/customize/connectors?modal=add-custom-connector
2. 为连接器设置名称，并粘贴mcp网址（基准网址 + /mcp）
3. 展开高级选项并输入oauth客户端ID和客户端密钥
## 功能
### 发现
- [x] 集群版本
- [x] 集群资源
- [x] 集群状态
- [x] 下一个/空闲集群vmid
- [x] 列出节点
- [x] 集群日志
- [x] 集群任务
### QEMU
- [x] 列出虚拟机
- [x] 获取虚拟机状态
- [x] 获取虚拟机配置
- [x] 更新虚拟机配置
- [x] 获取RRD数据
- [x] 电源操作（启动，停止，重置，重启，关闭，挂起，恢复）
- [ ] 迁移虚拟机
- [ ] 克隆虚拟机
- [ ] 删除虚拟机
- [ ] 列出快照
- [ ] 创建快照
- [ ] 回滚快照
- [ ] 删除快照
访客代理：
- [x] 命令执行
- [x] 获取网络接口
- [x] 获取操作系统信息
### LXC
- [x] 列出容器
- [x] 获取容器状态
- [x] 获取容器配置
- [x] 更新容器配置
- [x] 获取RRD数据
- [x] 电源操作（启动，停止，重启，关闭，挂起，恢复）
- [ ] 迁移容器
- [ ] 克隆容器
- [ ] 删除容器
- [ ] 列出快照
- [ ] 创建快照
- [ ] 回滚快照
- [ ] 删除快照
### 存储
- [x] 列出数据存储
- [x] 获取存储状态
- [x] 获取存储内容
- [x] 获取备份修剪信息
- [x] 列出磁盘
- [x] 获取磁盘SMART健康状态
- [x] 列出目录
- [x] 列出LVM卷
- [x] 列出LVMthin卷
- [x] 列出ZFS池
### 节点
- [x] 获取节点状态
- [x] 重启节点
- [x] 列出APT更新
- [x] 获取RRD数据
### 任务
- [x] 获取任务状态
- [x] 获取任务日志
- [x] 停止任务
待办事项：完成列表
