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.
Potencialize seu agente
Instalação do publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
Ainda não há uma versão empacotada no registro. Siga o README do repositório.
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no 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.
AbrirDo publicador
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.
Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
Beszel roda localmente via stdio.
Última verificação: 2026-10-27. MCP server for Beszel server monitoring: query server health, metrics, Docker containers and alerts from Claude or any MCP client.