Vault — крошечный персональный MCP-сервер

Заметки и закладки, хранящиеся в одном SQLite-файле, доступные для Claude через 5 инструментов: add_note, add_bookmark, search_notes, list_notes, delete_note.

1. Установка uv (однократно)

Откройте PowerShell и выполните:

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Закройте и снова откройте терминал, чтобы uv оказался в PATH.

Related MCP server: MCP Notes Server

2. Настройка проекта

Распакуйте эту папку в постоянное место, например C:\Users\<you>\mcp-vault. Затем внутри неё выполните:

cd C:\Users\<you>\mcp-vault
uv sync

Это создаёт виртуальное окружение и устанавливает fastmcp.

3. Тестирование в автономном режиме (до подключения к Claude Desktop)

uv run fastmcp dev server.py

Это откроет MCP Inspector в вашем браузере. Перейдите на вкладку Tools, попробуйте вызвать add_note с каким-нибудь текстом, затем list_notes — вы должны увидеть результат. Нажмите Ctrl+C, чтобы остановить, когда закончите.

4. Подключение к Claude Desktop

Откройте (или создайте) этот файл:

%APPDATA%\Claude\claude_desktop_config.json

Добавьте запись vault в раздел mcpServers. Если в файле уже есть другие серверы, просто добавьте этот ключ рядом с ними — не заменяйте весь файл.

{
  "mcpServers": {
    "vault": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "C:\\Users\\<you>\\mcp-vault",
        "fastmcp",
        "run",
        "server.py"
      ]
    }
  }
}

Замените C:\\Users\\<you>\\mcp-vault на реальный путь к папке — используйте двойные обратные слеши, как показано.

5. Перезапуск Claude Desktop

Полностью завершите его (правый клик по значку в трее → Quit, а не просто закрытие окна) и откройте снова. Найдите значок инструментов в поле чата — нажмите на него, и вы должны увидеть список из 5 инструментов vault.

6. Попробуйте

• «Сохрани заметку: renew passport, пометь тегом todo»

• «Сохрани ссылку: https://example.com, назови Example, пометь тегом reference»

• «Что я сохранил с тегом todo?»

• «Найди в моих заметках passport»

• «Удали заметку 1»

Ваши данные находятся в vault.db рядом с server.py — это обычный SQLite-файл, так что вы можете открыть его любым SQLite-браузером, если захотите посмотреть напрямую.

Screenshots

Примечания

• Каждый docstring инструмента — это то, что читает Claude, чтобы решить, когда его вызывать. Если вы переименовываете или меняете назначение инструмента, сохраняйте точность docstring — это весь интерфейс.

• Если Claude Desktop не видит сервер, проверьте %APPDATA%\Claude\logs\ на наличие ошибок — обычно проблема в неправильном пути в конфигурации.