Muninndb

1. Install

curl -sSL https://muninndb.com/install.sh | sh

2. Start (first-run setup is automatic)

muninn start

**Windows (PowerShell):**

1. Install

irm https://muninndb.com/install.ps1 | iex

2. Start (first-run setup is automatic)

muninn start

Examples

REST — the full cycle:

```bash

Configuration

MuninnDB works out of the box with no configuration. The bundled local embedder is included — offline, no API key, no setup.

When you're ready to customize:

Docker:

docker run -d \
  --name muninndb \
  -p 8474:8474 -p 8475:8475 -p 8476:8476 -p 8750:8750 \
  -v muninndb-data:/data \
  ghcr.io/scrypster/muninndb:latest

Full self-hosting guide →

---

Troubleshooting

<details> <summary>MCP connection fails with schema validation error</summary>

MuninnDB speaks both http and sse MCP transports — the server handles either. The "type" field in your config must match what your client expects:

• Claude Desktop v1.1.4010+: omit "type" entirely — the transport is inferred from the URL. Adding "type": "http" crashes Claude Desktop on startup.
• Most other tools (Cursor, Windsurf, VS Code, etc.): "type": "http" is correct.
• Older clients (Claude Code before v2.1.53): use "type": "sse".

If your tool reports a schema validation or config parsing error, try removing "type" or switching between "http" and "sse". </details>

<details> <summary>muninn_remember or muninn_recall hangs</summary>

Check that the server is running: muninn status. If the server is running but tools hang, check muninn logs for errors. The most common cause is a stale MCP config pointing to the wrong port — verify the URL in your config matches http://127.0.0.1:8750/mcp. </details>

<details> <summary>muninn: command not found</summary>

The binary must be in your PATH. On macOS/Linux, the default install location is ~/.local/bin/muninn — run echo $PATH to verify it includes ~/.local/bin. If not, add export PATH="$HOME/.local/bin:$PATH" to your ~/.zshrc or ~/.bashrc and restart your shell. On Windows, the default is %LOCALAPPDATA%\muninn — run $env:PATH in PowerShell to verify. </details>

<details> <summary>Windows: DLL or ORT initialization error on first start</summary>

The bundled local embedder uses ONNX Runtime, which requires the Visual C++ Redistributable on Windows. Most machines already have it. If you see an error about onnxruntime.dll or "ORT environment init", install the Visual C++ 2019+ Redistributable (x64) and restart muninn. </details>

---

Named after Muninn — one of Odin's two ravens, whose name means "memory" in Old Norse. Muninn flies across the nine worlds and returns what has been forgotten.

Built by MJ Bonanno · muninndb.com · BSL 1.1

---

MuninnDB is patent pending (U.S. Provisional Patent Application No. 63/991,402) and licensed under BSL 1.1.