Skip to main content
Glama

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

Variable

Erforderlich

Standard

Beschreibung

OBSIDIAN_API_KEY

ja

—

Bearer-Token vom Local REST API Plugin

OBSIDIAN_HOST

nein

127.0.0.1

Host, auf dem die REST-API von Obsidian lauscht

OBSIDIAN_PORT

nein

27123

Port für die REST-API

OBSIDIAN_PROTOCOL

nein

http

http oder https

PALACE_APPEND_DENY

nein

/Context/,/System/,Index.md

Kommagetrennte Pfade, in denen append_note blockiert ist

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

Werkzeug

Beschreibung

list_notes

Listet Dateien und Ordner auf. Geben Sie einen Unterverzeichnispfad an oder lassen Sie das Feld für das Vault-Wurzelverzeichnis leer.

read_note

Liest den vollständigen Inhalt einer Notiz über einen vault-relativen Pfad (z. B. People/Alice.md).

write_note

Erstellt eine neue Notiz oder überschreibt eine vorhandene.

append_note

Fügt Text am Ende einer Notiz hinzu. Erstellt die Notiz, falls sie nicht existiert.

search_notes

Volltextsuche; gibt passende Dateinamen nach Relevanz sortiert zurück.

active_note

Gibt den Inhalt der aktuell in Obsidian geöffneten Notiz zurück.

delete_note

Löscht eine Notiz dauerhaft. Unumkehrbar — mit Vorsicht verwenden.

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

Available Tools

7 tools
active_noteA

Return the contents of the note currently open in Obsidian.

Inputs: no named parameters. Returns: result

append_noteA

Append text to the end of a note (creates the note if it doesn't exist).

Inputs: path (required), content (required). Returns: result

delete_noteA

Permanently delete a note. Use with care — this is irreversible.

Inputs: path (required). Returns: result

list_notesA

List files and folders. Pass a subdirectory path, or leave empty for the vault root.

Inputs: directory. Returns: result

read_noteA

Read a note's full contents by vault-relative path, e.g. 'People/Alice.md'.

Inputs: path (required). Returns: result

search_notesA

Full-text search the vault; returns matching filenames ranked by relevance.

Inputs: query (required). Returns: result

write_noteA

Create a new note or OVERWRITE an existing one at the given vault-relative path.

Inputs: path (required), content (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool maps to a distinct file operation: listing, reading, writing, appending, searching, accessing the active note, and deleting. There is no meaningful overlap between tool purposes.

    Naming Consistency4/5

    Most tools follow a clear verb_note pattern: read_note, write_note, append_note, delete_note, and search_notes. The deviations are minor: list_notes uses plural and active_note is adjective_noun, but the overall convention is still predictable.

    Tool Count5/5

    Seven tools is a well-scoped set for an Obsidian vault server. Each tool covers a necessary note operation without unnecessary bloat.

    Completeness4/5

    The core note lifecycle is covered: list, read, write, append, search, and delete. Missing operations like rename, move, or folder management are minor gaps that agents can usually work around by writing to a new path.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides an MCP server that allows AI assistants to interact with Obsidian vaults, enabling reading/writing notes, managing metadata, searching content, and working with daily notes.
      37
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A local MCP server that wraps the Obsidian CLI to give AI assistants direct access to read, edit, and manage notes within an Obsidian vault. It enables advanced operations such as frontmatter property management, context-aware searching, and the execution of internal Obsidian commands.
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A lightweight MCP server that enables AI assistants to securely read, create, and modify notes in an Obsidian vault, with support for semantic search and web scraping.
      MIT