palace-mcp
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 syncKonfiguration
Variable | Erforderlich | Standard | Beschreibung |
| ja | — | Bearer-Token vom Local REST API Plugin |
| nein |
| Host, auf dem die REST-API von Obsidian lauscht |
| nein |
| Port für die REST-API |
| nein |
|
|
| nein |
| Kommagetrennte Pfade, in denen |
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.pyOder über FastMCP:
uv run fastmcp run server.pyCursor-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 |
| Listet Dateien und Ordner auf. Geben Sie einen Unterverzeichnispfad an oder lassen Sie das Feld für das Vault-Wurzelverzeichnis leer. |
| Liest den vollständigen Inhalt einer Notiz über einen vault-relativen Pfad (z. B. |
| Erstellt eine neue Notiz oder überschreibt eine vorhandene. |
| Fügt Text am Ende einer Notiz hinzu. Erstellt die Notiz, falls sie nicht existiert. |
| Volltextsuche; gibt passende Dateinamen nach Relevanz sortiert zurück. |
| Gibt den Inhalt der aktuell in Obsidian geöffneten Notiz zurück. |
| 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 einemContext-Ordner)/System/(jede Notiz unter einemSystem-Ordner)Index.md(jede Datei namensIndex.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 toolsactive_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
Scored across 7 tools
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.
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.
Seven tools is a well-scoped set for an Obsidian vault server. Each tool covers a necessary note operation without unnecessary bloat.
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.
Related MCP Connectors
Hosted MCP server for Obsidian Sync vaults: read, search, edit notes. Not affiliated with Obsidian.
Markdown-based note-taking with a hosted MCP server. Your notes serve you and your AI.
Google Keep-style notes app with an MCP server for AI agents to read/write notes.
Search your AI chat history (ChatGPT, Claude, Codex) from any MCP client. Remote, private, read-only
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceProvides 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.37MIT
- AlicenseNot gradedqualityDmaintenanceA 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.2MIT
- AlicenseBqualityDmaintenanceAn MCP server that enables AI assistants to access and manage your local Obsidian vault through a standardized protocol.144,244 npm2Apache 2.0
- AlicenseNot gradedqualityDmaintenanceA 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