palace-mcp

MCP-сервер, который предоставляет AI-ассистентам доступ к хранилищу Obsidian через плагин Local REST API.

Создан на базе FastMCP. Агенты могут перечислять, читать, записывать, искать и удалять заметки, а также читать ту заметку, которая в данный момент открыта в Obsidian.

Предварительные требования

• Obsidian с установленным и запущенным плагином Local REST API

• Python 3.12+

• uv (рекомендуется) или pip

Скопируйте ваш API-ключ из настроек плагина в Obsidian перед продолжением.

Related MCP server: obsidian-local-mcp

Установка

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

Конфигурация

При использовании HTTPS с самоподписанным сертификатом плагина проверка сертификата автоматически пропускается.

Запуск

Запустите сервер через stdio (транспорт по умолчанию для MCP-клиентов):

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

Или через FastMCP:

uv run fastmcp run server.py

Настройка Cursor

Добавьте в ваш MCP-конфиг (например, ~/.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"
      }
    }
  }
}

Перезапустите Cursor или перезагрузите MCP-серверы после сохранения.

Инструменты

Защита от добавления

Некоторые пути хранилища считаются только для перезаписи. Добавление к ним может незаметно накапливать дублирующееся содержимое внутри одной заметки, что впоследствии трудно обнаружить.

По умолчанию append_note отклоняется для путей, соответствующих:

• /Context/ (любая заметка в папке Context)

• /System/ (любая заметка в папке System)

• Index.md (любой файл с именем Index.md)

Используйте write_note, чтобы заменять такие заметки. Переопределите список запретов с помощью переменной окружения PALACE_APPEND_DENY.

Лицензия

MIT