@bldg-7/proxmox-mcp 0.1.0 → 0.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +3 -9
- package/dist/utils/index.js +1 -1
- package/dist/utils/index.js.map +1 -1
- package/package.json +19 -15
package/README.md
CHANGED
|
@@ -39,7 +39,7 @@ This project is a TypeScript rewrite of [mcp-proxmox-server](https://github.com/
|
|
|
39
39
|
- **55 comprehensive tools** for Proxmox management
|
|
40
40
|
- **Full TypeScript implementation** with strict type safety
|
|
41
41
|
- **Support for both QEMU VMs and LXC containers**
|
|
42
|
-
- **Secure authentication** (
|
|
42
|
+
- **Secure authentication** (API token)
|
|
43
43
|
- **Flexible SSL modes** (strict, verify, insecure)
|
|
44
44
|
- **Permission-based access control** (basic vs elevated operations)
|
|
45
45
|
- **Comprehensive error handling** with structured responses
|
|
@@ -64,8 +64,7 @@ Set the following environment variables before starting the server:
|
|
|
64
64
|
| Variable | Required | Description | Default |
|
|
65
65
|
|----------|----------|-------------|---------|
|
|
66
66
|
| `PROXMOX_HOST` | **Yes** | Proxmox server hostname or IP address | - |
|
|
67
|
-
| `PROXMOX_USER` |
|
|
68
|
-
| `PROXMOX_PASSWORD` | **Yes** | User password | - |
|
|
67
|
+
| `PROXMOX_USER` | No | Username with realm (e.g., `root@pam`) | `root@pam` |
|
|
69
68
|
| `PROXMOX_TOKEN_NAME` | **Yes** | API token name | - |
|
|
70
69
|
| `PROXMOX_TOKEN_VALUE` | **Yes** | API token value | - |
|
|
71
70
|
| `PROXMOX_SSL_MODE` | No | SSL verification mode | `strict` |
|
|
@@ -94,8 +93,6 @@ This prevents accidental destructive operations and provides an additional safet
|
|
|
94
93
|
```bash
|
|
95
94
|
# With environment variables
|
|
96
95
|
export PROXMOX_HOST=pve.example.com
|
|
97
|
-
export PROXMOX_USER=root@pam
|
|
98
|
-
export PROXMOX_PASSWORD=your-password
|
|
99
96
|
export PROXMOX_TOKEN_NAME=mytoken
|
|
100
97
|
export PROXMOX_TOKEN_VALUE=abc123-def456-ghi789
|
|
101
98
|
export PROXMOX_SSL_MODE=verify
|
|
@@ -116,8 +113,6 @@ Add to your Claude Desktop configuration (`~/Library/Application Support/Claude/
|
|
|
116
113
|
"args": ["-y", "@bldg-7/proxmox-mcp"],
|
|
117
114
|
"env": {
|
|
118
115
|
"PROXMOX_HOST": "pve.example.com",
|
|
119
|
-
"PROXMOX_USER": "root@pam",
|
|
120
|
-
"PROXMOX_PASSWORD": "your-password",
|
|
121
116
|
"PROXMOX_TOKEN_NAME": "mytoken",
|
|
122
117
|
"PROXMOX_TOKEN_VALUE": "abc123-def456-ghi789",
|
|
123
118
|
"PROXMOX_SSL_MODE": "verify",
|
|
@@ -961,8 +956,7 @@ All tools return structured responses following the MCP protocol:
|
|
|
961
956
|
**Problem**: `401 Unauthorized` or authentication failed
|
|
962
957
|
|
|
963
958
|
**Solutions**:
|
|
964
|
-
- Verify `PROXMOX_USER` includes realm (e.g., `root@pam`, not just `root`)
|
|
965
|
-
- Check `PROXMOX_PASSWORD` is correct
|
|
959
|
+
- Verify `PROXMOX_USER` includes realm if set (e.g., `root@pam`, not just `root`)
|
|
966
960
|
- Verify `PROXMOX_TOKEN_NAME` and `PROXMOX_TOKEN_VALUE` are valid
|
|
967
961
|
- Ensure API token has sufficient permissions in Proxmox
|
|
968
962
|
|
package/dist/utils/index.js
CHANGED
package/dist/utils/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,MAAM;IAC9C,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,MAAM;IAC9C,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,CAAC,CAAC,CAAC;QAClD,MAAM,EAAE,aAAa;KACtB,CAAC,CAAC,CAAC,SAAS;CACd,CAAC,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@bldg-7/proxmox-mcp",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.3",
|
|
4
4
|
"description": "Proxmox MCP Server - TypeScript rewrite",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -9,28 +9,20 @@
|
|
|
9
9
|
"proxmox-mcp": "dist/index.js"
|
|
10
10
|
},
|
|
11
11
|
"engines": {
|
|
12
|
-
"node": ">=
|
|
12
|
+
"node": ">=24"
|
|
13
13
|
},
|
|
14
14
|
"files": [
|
|
15
15
|
"dist/",
|
|
16
16
|
"README.md",
|
|
17
17
|
"LICENSE"
|
|
18
18
|
],
|
|
19
|
+
"repository": {
|
|
20
|
+
"type": "git",
|
|
21
|
+
"url": "https://github.com/Bldg-7/proxmox-mcp"
|
|
22
|
+
},
|
|
19
23
|
"publishConfig": {
|
|
20
24
|
"access": "public"
|
|
21
25
|
},
|
|
22
|
-
"scripts": {
|
|
23
|
-
"build": "tsc",
|
|
24
|
-
"dev": "tsc --watch",
|
|
25
|
-
"start": "node dist/index.js",
|
|
26
|
-
"test": "vitest run",
|
|
27
|
-
"test:watch": "vitest",
|
|
28
|
-
"test:coverage": "vitest run --coverage",
|
|
29
|
-
"lint": "eslint src --ext .ts",
|
|
30
|
-
"typecheck": "tsc --noEmit",
|
|
31
|
-
"clean": "rm -rf dist",
|
|
32
|
-
"release": "pnpm build && changeset publish"
|
|
33
|
-
},
|
|
34
26
|
"dependencies": {
|
|
35
27
|
"@modelcontextprotocol/sdk": "^1.25.3",
|
|
36
28
|
"dotenv": "^16.4.5",
|
|
@@ -47,5 +39,17 @@
|
|
|
47
39
|
"pino-pretty": "^11.2.2",
|
|
48
40
|
"typescript": "^5.6.3",
|
|
49
41
|
"vitest": "^2.1.8"
|
|
42
|
+
},
|
|
43
|
+
"scripts": {
|
|
44
|
+
"build": "tsc",
|
|
45
|
+
"dev": "tsc --watch",
|
|
46
|
+
"start": "node dist/index.js",
|
|
47
|
+
"test": "vitest run",
|
|
48
|
+
"test:watch": "vitest",
|
|
49
|
+
"test:coverage": "vitest run --coverage",
|
|
50
|
+
"lint": "eslint src --ext .ts",
|
|
51
|
+
"typecheck": "tsc --noEmit",
|
|
52
|
+
"clean": "rm -rf dist",
|
|
53
|
+
"release": "pnpm build && changeset publish"
|
|
50
54
|
}
|
|
51
|
-
}
|
|
55
|
+
}
|