Proxmox MCP Server (Node.js Edition)

@gilby125

代码仓库

基本信息

分类

其他

许可证

MIT license

传输方式

stdio

作者

gilby125

关于 Proxmox MCP Server

MCP server for Proxmox virtualization management with configurable permissions

#proxmox #mcp-server #nodejs

Proxmox MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-proxmox-gilby125": {
      "command": "node",
      "args": [
        "index.js"
      ]
    }
  }
}

Proxmox MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is 🚀 Proxmox MCP Server (Node.js Edition)?

A Node.js-based Model Context Protocol (MCP) server for interacting with Proxmox hypervisors, providing a clean interface for managing nodes, VMs, and containers with configurable permission levels. It is a rewrite of the original Python implementation, adapted for JavaScript/Node.js environments.

How to use 🚀 Proxmox MCP Server (Node.js Edition)?

Clone the repository, run npm install, create a .env file with your Proxmox credentials (host, user, token name, token value), and optionally set PROXMOX_ALLOW_ELEVATED. Start the server with node index.js. Integrate with MCP clients by adding a configuration entry pointing to the index.js file.

Key features of 🚀 Proxmox MCP Server (Node.js Edition)

🔒 Configurable permission levels (Basic and Elevated)
🛠️ Built with the official MCP SDK for Node.js
🔐 Secure token-based authentication with Proxmox
🖥️ Comprehensive node and VM management
💻 VM console command execution (elevated mode)
📊 Real-time resource monitoring and rich markdown output

Use cases of 🚀 Proxmox MCP Server (Node.js Edition)

List Proxmox cluster nodes and their status
View detailed VM/container information and resource usage
Execute shell commands on VMs via the Proxmox API (elevated)
Monitor storage pools and cluster health
Integrate with AI assistants (e.g., Claude Code) for hands‑off hypervisor management

常见问题

What is Basic Mode vs Elevated Mode?

Basic Mode allows safe operations like listing nodes and VMs with minimal API token permissions. Elevated Mode adds advanced features like detailed node metrics, VM command execution, and requires extra permissions (Sys.Audit, VM.Monitor, VM.Console).

What environment variables are required?

You must set `PROXMOX_HOST`, `PROXMOX_USER`, `PROXMOX_TOKEN_NAME`, and `PROXMOX_TOKEN_VALUE`. Optionally set `PROXMOX_PORT` (default 8006) and `PROXMOX_ALLOW_ELEVATED` (default false).

How do I set up a Proxmox API token?

In the Proxmox web interface go to Datacenter → Permissions → API Tokens, add a token for a user, copy the Token ID and Secret immediately, then use them as `PROXMOX_TOKEN_NAME` and `PROXMOX_TOKEN_VALUE`.

What tools does the server expose?

Seven tools: `proxmox_get_nodes`, `proxmox_get_node_status`, `proxmox_get_vms`, `proxmox_get_vm_status`, `proxmox_get_storage`, `proxmox_get_cluster_status`, and `proxmox_execute_vm_command` (elevated only).

What are the runtime dependencies?

Node.js 16+, npm, and the npm packages `@modelcontextprotocol/sdk` and `node-fetch`. No other external services are needed beyond a Proxmox server.

其他分类下的更多 MCP 服务器

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct