Skip to content
Vladimir Kochnev edited this page Nov 17, 2026 · 2 revisions

Panel

mcprig panel serves a web panel over the same state the proxy uses: the registry of servers, the sets, their keys, the tool quarantine and the call statistics. It is a single embedded page (no build step, no CDN), so the assets always match the binary you run.

MCPRIG_HOST=127.0.0.1  MCPRIG_PORT=9091  MCPRIG_PASSWORD=…  mcprig panel

Pages

The address is the state: every page has its own link.

route page
#/ host overview — sets running, servers by health, tools to approve, calls and errors in the last 7 days
#/sets the list of sets; a row opens the set
#/set/<id>/overview one set: running state, endpoint, tiles
#/set/<id>/servers attach, detach, probe, log, edit the set's servers
#/set/<id>/keys issue, label and revoke keys; the token is shown once
#/set/<id>/tools the set's tools, quarantine approvals
#/set/<id>/calls call log with filters, live tail
#/set/<id>/logs the set's log
#/stats/<period> statistics: today, 7d, 30d, archive
#/servers the registry: every server, with check/log/edit/delete
#/vars environment variables for sets, stored in the file or OpenBao

An unknown tab falls back to overview; an unknown route opens the set list.

What the panel does

  • Sets. Create, rename, move the port, attach servers, start, stop, restart, delete. Deleting the open set returns you to the list.
  • Servers. One registry for every set. A server knows its transport (stdio command and cwd, or a remote URL), environment, tags, and the sandbox mode. Check probes it without touching a set.
  • Keys. A key is a profile: it filters which tools a client sees and carries the label used in statistics. Revoking an active key stops the set — a set with no key has nobody to serve.
  • Tool quarantine. When a set checks tool descriptors against tools.lock.json, new or changed tools wait for approval instead of appearing silently.
  • Calls and statistics. Every call is recorded: server, tool, client, status, duration. The statistics page aggregates by period with filters.
  • Import/export. Sets and the registry can be downloaded as JSON and loaded back; Prompt builds a ready-made client prompt for a set.

Look

Two independent axes: default (plain, modern) and win98 (the beveled look), each with its own palettes — dark, light, nord, gruvbox for default; w98, w98-cool, w98-warm, w98-hc for win98. Both are remembered separately; the language is EN or RU. Everything is keyboard reachable, AA contrast, tap targets at least 32 px.

Auth

what is set mode
MCPRIG_AUTH=off none (loopback only, by the host allowlist)
MCPRIG_PASSWORD or MCPRIG_PASSWORD_HASH login form, cookie session
MCPRIG_PROXY_SECRET a trusted proxy asserts the user in MCPRIG_USER_HEADER

Writes (POST/PUT/PATCH/DELETE) are checked against the Host allowlist and refuse a foreign Origin; a write carrying a session cookie must also carry its own Origin (403 «не хватает заголовка Origin» without one), while a request without a cookie — a plain curl, a script — is served.

Details: docs/en/panel.md.

Clone this wiki locally