palace-mcp

MCP-Server, der einen Obsidian-Vault über das Local REST API-Plugin für KI-Assistenten bereitstellt.

Erstellt mit FastMCP. Agenten können Notizen auflisten, lesen, schreiben, durchsuchen und löschen — und die Notiz lesen, die gerade in Obsidian geöffnet ist.

Voraussetzungen

• Obsidian mit installiertem und ausgeführtem Local REST API-Plugin

• Python 3.12+

• uv (empfohlen) oder pip

Kopieren Sie vor dem Fortfahren Ihren API-Schlüssel aus den Plugin-Einstellungen in Obsidian.

Related MCP server: obsidian-local-mcp

Installation

git clone <repo-url> palace-mcp
cd palace-mcp
uv sync

Konfiguration

Bei Verwendung von HTTPS mit dem selbstsignierten Zertifikat des Plugins wird die Zertifikatsprüfung automatisch übersprungen.

Ausführen

Starten Sie den Server über stdio (der Standardtransport für MCP-Clients):

export OBSIDIAN_API_KEY="your-api-key"
uv run python server.py

Oder über FastMCP:

uv run fastmcp run server.py

Cursor-Einrichtung

Fügen Sie Ihrer MCP-Konfiguration (z. B. ~/.cursor/mcp.json) Folgendes hinzu:

{
  "mcpServers": {
    "obsidian-palace": {
      "command": "uv",
      "args": ["run", "python", "server.py"],
      "cwd": "/path/to/palace-mcp",
      "env": {
        "OBSIDIAN_API_KEY": "your-api-key-here"
      }
    }
  }
}

Starten Sie Cursor neu oder laden Sie die MCP-Server nach dem Speichern neu.

Werkzeuge

Schutz beim Anhängen

Einige Vault-Pfade werden als nur überschreibbar behandelt. Das Anhängen an diese Pfade kann stillschweigend doppelte Inhalte in einer einzelnen Notiz ansammeln, was später schwer zu erkennen ist.

Standardmäßig wird append_note für Pfade verweigert, die Folgendem entsprechen:

• /Context/ (jede Notiz unter einem Context-Ordner)

• /System/ (jede Notiz unter einem System-Ordner)

• Index.md (jede Datei namens Index.md)

Verwenden Sie stattdessen write_note, um diese Notizen zu ersetzen. Sie können die Verweigerungsliste mit der Umgebungsvariablen PALACE_APPEND_DENY überschreiben.

Lizenz

MIT