Connecting io.github.ObscuritySRL/umbriel to Claude Code

To connect to io.github.ObscuritySRL/umbriel, you need to have an MCP client installed. The server works with standard MCP clients, so you can use any client that supports MCP. Once you have the client installed, you can proceed to set up the environment variables.

Paste this into your MCP client config, then restart the client.

{
  "mcpServers": {
    "umbriel": {
      "command": "npx",
      "args": [
        "-y",
        "umbriel"
      ]
    }
  }
}

To configure io.github.ObscuritySRL/umbriel, you need to set up several environment variables. The UMBRIEL_PROFILE variable is optional, and you can set it to a specific profile if needed. The UMBRIEL_OS variable allows you to enable the 'os' and 'fs' tools by setting it to '1'. You can also set the UMBRIEL_ALLOW and UMBRIEL_DENY variables to control access to specific tools or categories.

After setting up the environment variables, you can check if the server has appeared in the client and if its tools are callable. Check the client's tools and features to confirm that io.github.ObscuritySRL/umbriel is connected and working as expected.

If the server does not appear in the client or its tools are not callable, you can try troubleshooting the connection. Check the environment variables and ensure that they are set up correctly. Also, check the client's configuration and ensure that it is set up to work with io.github.ObscuritySRL/umbriel.

For advanced configuration, you can set up additional environment variables such as UMBRIEL_CURSOR, UMBRIEL_FS_ROOT, UMBRIEL_TRACE, and UMBRIEL_FFI_TRACE. These variables allow you to customize the behavior of io.github.ObscuritySRL/umbriel and provide additional features such as cursor control and tracing.