io.github.ObscuritySRL/umbriel MCP Server
io.github.ObscuritySRL/umbriel
What this kind of tool is for
- Automate a build, test, or deployment step you repeat by hand.
- Review or refactor code in an existing repository without leaving your agent.
- Bridge an internal service or CLI into the agent toolset.
How to compare servers like this
- Scope of control:
- Repos and CI are hard to undo; prefer tools that ask before anything irreversible.
- Environment fit:
- Match the runtime it expects (Node, Python, a container) to what you actually run.
- Maintenance signal:
- Check the last-commit date — dev tooling that lags upstream breaks first.
- Config surface:
- Prefer tools whose environment-variable or config keys are documented plainly.
This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.
What is the io.github.ObscuritySRL/umbriel MCP server?
See and drive a whole Windows machine from Bun — apps, input, screen, OCR, registry, OS — via MCP.
How to install io.github.ObscuritySRL/umbriel
Copy-paste configuration for popular MCP clients.
UMBRIEL_PROFILECapability profile: 'readonly' (inspect/read only), 'safe' (read + input + window — default), or 'full' (also os + fs tools).
UMBRIEL_OSSet to '1' to allow the 'os' tools (launch_app/run_program/open_path, kill_process, manage_process, control_service, set_env, registry_get/registry_list/registry_set) AND the 'fs' tools (read_file/write_file/list_dir/stat_path/make_dir/copy_file/move_file/delete_file) regardless of profile.
UMBRIEL_ALLOWComma-separated tool names or categories to additionally allow on top of the profile.
UMBRIEL_DENYComma-separated tool names or categories to deny, overriding the profile and UMBRIEL_ALLOW.
UMBRIEL_CURSORSet to 'never' to forbid the real-cursor fallback entirely (strictly cursor-free). By default clicks/drags are cursor-free but fall back to the real hardware cursor when no cursor-free path exists.
UMBRIEL_FS_ROOTSandbox root directory that the fs-category file tools (read_file/write_file/list_dir/stat_path/make_dir/copy_file/move_file/delete_file) are confined to when fs tools are enabled; open_path's path argument is honored too.
UMBRIEL_TRACEFile path to journal every mutating tool call as JSON Lines (tool, category, masked args, ok, observation); secret-bearing args and values are redacted. Unset = no trace.
UMBRIEL_FFI_TRACEFile path to a flush-before-call diagnostic journal of every COM vcall (slot, this-pointer, arg count). Each line is written and flushed to the OS BEFORE the native call, so after an uncatchable crash the last line names the faulting call. Has per-call overhead; unset = off. For debugging native faults only.
UMBRIEL_AUDITControls the default-on stderr audit of mutating tool calls. 'off' is the explicit opt-out (reported at startup); 'verbose' also audits reads.
UMBRIEL_REDACTCredential masking (default on). 'off' opts out; a regex value overrides the built-in secret shapes masked in clipboard/env/registry reads and the trace journal.
{
"mcpServers": {
"umbriel": {
"command": "bunx",
"args": [
"-y",
"umbriel"
],
"env": {
"UMBRIEL_PROFILE": "<YOUR_UMBRIEL_PROFILE>",
"UMBRIEL_OS": "<YOUR_UMBRIEL_OS>",
"UMBRIEL_ALLOW": "<YOUR_UMBRIEL_ALLOW>",
"UMBRIEL_DENY": "<YOUR_UMBRIEL_DENY>",
"UMBRIEL_CURSOR": "<YOUR_UMBRIEL_CURSOR>",
"UMBRIEL_FS_ROOT": "<YOUR_UMBRIEL_FS_ROOT>",
"UMBRIEL_TRACE": "<YOUR_UMBRIEL_TRACE>",
"UMBRIEL_FFI_TRACE": "<YOUR_UMBRIEL_FFI_TRACE>",
"UMBRIEL_AUDIT": "<YOUR_UMBRIEL_AUDIT>",
"UMBRIEL_REDACT": "<YOUR_UMBRIEL_REDACT>"
}
}
}
}Related MCP servers

Win32 FFI bindings for Bun on Windows—control native GUIs and system APIs with zero dependencies.

Drive OctoPerf load testing from any AI agent: import, edit, validate, run scenarios, read metrics.

Persistent file-based memory for AI agents: inspectable, versionable, fully local.

Rhizome MCP
Local-first MCP server for task tracking and coordination of autonomous AI coding agents.

Umami v3 MCP for Cloud or self-hosted analytics, with read-only, privacy-conscious defaults.

Live web search and URL extraction with LLM-ready markdown, page categories, and query-driven highlights.