Vault – ein winziger persönlicher MCP-Server

Notizen + Lesezeichen, gespeichert in einer einzigen SQLite-Datei, Claude über 5 Tools zur Verfügung gestellt: add_note, add_bookmark, search_notes, list_notes, delete_note.

1. uv installieren (einmalig)

Öffnen Sie PowerShell und führen Sie aus:

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Schließen und öffnen Sie Ihr Terminal danach erneut, damit uv im PATH ist.

Related MCP server: MCP Notes Server

2. Projekt einrichten

Entpacken Sie diesen Ordner an einen dauerhaften Ort, z. B. C:\Users\<you>\mcp-vault. Führen Sie dann darin aus:

cd C:\Users\<you>\mcp-vault
uv sync

Dies erstellt eine virtuelle Umgebung und installiert fastmcp.

3. Eigenständig testen (bevor Sie Claude Desktop berühren)

uv run fastmcp dev server.py

Dies öffnet den MCP Inspector in Ihrem Browser. Klicken Sie auf den Tab Tools, versuchen Sie, add_note mit etwas Text aufzurufen, dann list_notes – Sie sollten sehen, dass es zurückkommt. Drücken Sie Strg+C, um es zu beenden, wenn Sie zufrieden sind.

4. In Claude Desktop einbinden

Öffnen Sie (oder erstellen Sie) diese Datei:

%APPDATA%\Claude\claude_desktop_config.json

Fügen Sie einen vault-Eintrag unter mcpServers hinzu. Wenn die Datei bereits andere Server enthält, fügen Sie diesen Schlüssel einfach daneben hinzu – ersetzen Sie nicht die gesamte Datei.

{
  "mcpServers": {
    "vault": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "C:\\Users\\<you>\\mcp-vault",
        "fastmcp",
        "run",
        "server.py"
      ]
    }
  }
}

Ersetzen Sie C:\\Users\\<you>\\mcp-vault durch den tatsächlichen Speicherort des Ordners – verwenden Sie doppelte Backslashes wie gezeigt.

5. Claude Desktop neu starten

Beenden Sie es vollständig (Rechtsklick auf das Taskleistensymbol → Beenden, nicht nur das Fenster schließen) und öffnen Sie es erneut. Suchen Sie nach dem Tools-Symbol im Chat-Feld – klicken Sie darauf und Sie sollten die 5 Vault-Tools aufgelistet sehen.

6. Ausprobieren

• "Save a note: renew passport, tag it todo"

• "Save this link: https://example.com, title it Example, tag it reference"

• "What have I saved tagged todo?"

• "Search my notes for passport"

• "Delete note 1"

Ihre Daten befinden sich in vault.db direkt neben server.py – es ist nur eine SQLite-Datei, Sie können sie also mit jedem SQLite-Browser öffnen, wenn Sie direkt darin stöbern möchten.

Screenshots

Notes

• Der Docstring jedes Tools ist das, was Claude liest, um zu entscheiden, wann es aufgerufen wird – wenn Sie ein Tool umbenennen oder umfunktionieren, halten Sie den Docstring genau, das ist die gesamte Schnittstelle.

• Wenn Claude Desktop den Server nicht erkennt, überprüfen Sie %APPDATA%\Claude\logs\ auf Fehler – normalerweise liegt ein falscher Pfad in der Konfiguration vor.