beszel-mcp
A Model Context Protocol (MCP) server for Beszel — the lightweight server monitoring platform. Query your servers' health, metrics, containers, and alerts directly from Claude or any MCP-compatible client.
Power your agent
पब्लिशर का इंस्टॉल। PlugMCP एंडपॉइंट नहीं।
Host a copy with our keys and logs.
रजिस्ट्री में अभी कोई पैकेज्ड रिलीज़ नहीं है। रिपॉज़िटरी का README देखें.
रिमोट URL या आपकी मशीन पर कमांड? दोनों इंस्टॉल में क्या अंतर है
PlugMCP पर चलाएँ
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
लॉन्चपब्लिशर से
A Model Context Protocol (MCP) server for Beszel — the lightweight server monitoring platform. Query your servers' health, metrics, containers, and alerts directly from Claude or any MCP-compatible client.
MCP server for Beszel server monitoring: query server health, metrics, Docker containers and alerts from Claude or any MCP client.
git clone https://github.com/yourusername/beszel-mcp
cd beszel-mcp
go mod tidy
go build -o beszel-mcp .
The server is configured entirely via environment variables:
Tip: Admin accounts can see all systems; regular users only see systems they own.
Add the following to your claude_desktop_config.json:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"beszel": {
"command": "/absolute/path/to/beszel-mcp",
"env": {
"BESZEL_URL": "http://localhost:8090",
"BESZEL_EMAIL": "[email protected]",
"BESZEL_PASSWORD": "yourpassword"
}
}
}
}
Restart Claude Desktop. You should see the Beszel tools available in the tools menu.
Run directly:
BESZEL_URL=http://localhost:8090 \
[email protected] \
BESZEL_PASSWORD=yourpassword \
./beszel-mcp
Or with environment file:
# .env
BESZEL_URL=http://localhost:8090
[email protected]
BESZEL_PASSWORD=yourpassword
env $(cat .env | xargs) ./beszel-mcp
Once connected to Claude, try these:
abc123xyz"list_systemsLists all systems accessible to the authenticated user.
Parameters:
status_filter (optional) — "up", "down", "paused", or "pending"Example output:
Found 3 system(s):
### ✅ prod-web
ID: abc123xyz
Host: 192.168.1.10:45876
Status: up
OS: Linux
Agent: v0.18.6
CPU: 12.3%
Memory: 45.1%
Disk: 61.0%
Load: 0.85 / 0.72 / 0.68
Uptime: 14d 6h 22m
search_systemsFilter systems using PocketBase filter syntax.
Parameters:
filter (required) — Filter expressionFilter examples:
get_system_statsDetailed metrics for a single system.
Parameters:
system_id (required) — System record IDresolution (optional) — Data granularity:
"1m" — most recent ~1 hour of 1-minute samples"10m" — last ~12 hours (default)"20m" — last ~24 hours"120m" — last ~7 days"480m" — last ~30 dayslist_docker_containersLists Docker/Podman containers.
Parameters:
system_id (optional) — Limit to one system; omit for all systemsColumns: Name, CPU%, Memory (GB), Network (bytes/s), Health, Image
list_alertsShows alert rules and their triggered state.
Parameters:
all (optional, bool) — true = show all rules; false (default) = only triggeredbeszel-mcp/
├── main.go # Entry point, env config, server bootstrap
├── go.mod
├── internal/
│ ├── client/
│ │ └── beszel.go # PocketBase REST client, auth token cache
│ └── tools/
│ └── tools.go # MCP tool definitions and handlers
└── README.md
The client automatically handles JWT authentication and token refresh. Tokens are cached in-memory and refreshed proactively before expiry.
https:// in BESZEL_URLMIT
MCP server for Beszel server monitoring: query server health, metrics, Docker containers and alerts from Claude or any MCP client.
टूल
अभी टूल सूची नहीं है। रिमोट सर्वर को पहले हेल्थ चेक के बाद सूची मिलती है।
FAQ
इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए stdio कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
इस रिकॉर्ड में कोई ज़रूरी एनवायरनमेंट वेरिएबल दर्ज नहीं है।
Beszel stdio पर लोकल चलता है।
पिछली जाँच 2026-10-27 को हुई। MCP server for Beszel server monitoring: query server health, metrics, Docker containers and alerts from Claude or any MCP client.