MCP Server Proxmox

Proxmox VE的MCP服务器

 ](https://nodejs.org/) 

A. 模型上下文协议（MCP）服务器 为了 Proxmox虚拟环境 它使AI助手能够通过自然语言交互来管理虚拟机、容器、节点和资源。

🚀 特性

• 节点管理：列出并监视Proxmox群集节点
• VM操作：启动、停止和监视虚拟机
• 容器管理：管理LXC容器
• 状态监测：节点、虚拟机和容器的实时状态信息
• 安全认证：同时支持密码和API令牌身份验证
• 多节点支持：适用于单节点或完整的Proxmox集群

📋 先决条件

• Node.js 18.0.0或更高版本
• 具有API访问权限的Proxmox VE 7.0+
• 有效的Proxmox凭据（用户名/密码或API令牌）

🛠️ 安装

来源

git clone https://github.com/heybearc/mcp-server-proxmox.git
cd mcp-server-proxmox
npm install
npm run build

来自NPM（即将推出）

npm install -g mcp-server-proxmox

⚙️ 配置

环境变量

创建一个 .env 文件或设置以下环境变量：

# 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:

{
  "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客户端的文档。

🔧 可用工具

💡 使用示例

使用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直接使用

# Start the server
npm start

# The server communicates via stdio using MCP protocol

🔐 安全

API令牌设置（推荐）

1. 登录Proxmox web界面
2. 首选 数据中心 → 权限 → API令牌
3. 创建具有适当权限的新令牌
4. 在配置中使用令牌

必需的权限

• VM.Audit -查看VM信息
• VM.PowerMgmt -启动/停止虚拟机
• Sys.Audit -查看节点信息
• Datastore.Audit -查看存储信息

🧪 发展

# 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文档

📞 支持

• 🐛 报告问题
• 💬 讨论
• 📧 联系