MCP.so
Sign In

🚀 Proxmox MCP Server (Node.js Edition)

@gilby125

Repository

About 🚀 Proxmox MCP Server (Node.js Edition)

MCP server for Proxmox virtualization management with configurable permissions

#proxmox#mcp-server#nodejs

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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

FAQ from 🚀 Proxmox MCP Server (Node.js Edition)

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.

Frequently asked questions

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.

Comments

Basic information

Category

Other

License

MIT license

Transports

stdio

Author

gilby125

More Other MCP servers

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

IDA Pro MCP

mrexodia

AI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP.

9.9K

MCP Go 🚀

mark3labs

A Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.

8.9K

Inbox Zero AI MCP

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K