palace-mcp

Servidor MCP que expone una bóveda de Obsidian a asistentes de IA mediante el plugin Local REST API.

Construido con FastMCP. Los agentes pueden listar, leer, escribir, buscar y eliminar notas — y leer la nota que esté abierta actualmente en Obsidian.

Requisitos previos

• Obsidian con el plugin Local REST API instalado y en ejecución

• Python 3.12+

• uv (recomendado) o pip

Copia tu clave de API desde los ajustes del plugin en Obsidian antes de continuar.

Related MCP server: obsidian-local-mcp

Instalación

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

Configuración

Al usar HTTPS con el certificado autofirmado del plugin, la verificación del certificado se omite automáticamente.

Ejecución

Inicia el servidor a través de stdio (el transporte predeterminado para clientes MCP):

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

O mediante FastMCP:

uv run fastmcp run server.py

Configuración de Cursor

Añade a tu configuración de MCP (p. ej. ~/.cursor/mcp.json):

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

Reinicia Cursor o recarga los servidores MCP después de guardar.

Herramientas

Protección contra añadidos

Algunas rutas de la bóveda se tratan como solo sobrescritura. Añadir contenido a ellas puede acumular silenciosamente contenido duplicado dentro de una misma nota, lo que resulta difícil de detectar más adelante.

Por defecto, append_note se rechaza para rutas que coincidan con:

• /Context/ (cualquier nota dentro de una carpeta Context)

• /System/ (cualquier nota dentro de una carpeta System)

• Index.md (cualquier archivo llamado Index.md)

En su lugar, usa write_note para reemplazar estas notas. Anula la lista de denegación con la variable de entorno PALACE_APPEND_DENY.

Licencia

MIT