Burn — MCP-сервер для личной базы знаний

npm version License: MIT

Ваши данные для чтения как база знаний, доступная для ИИ. 26 инструментов для Claude, Cursor, Windsurf и любого агента, совместимого с MCP.

Как это работает

Burn сортирует ваши материалы для чтения с помощью 24-часового таймера:

Flame (Пламя) → Новые ссылки. 24 часа на прочтение, иначе они сгорают.
Spark (Искра) → Вы прочитали. Хранится 30 дней.
Vault (Хранилище) → Постоянное хранение. Ваша курируемая база знаний.
Ash (Пепел) → Истекший срок. У них был шанс.

MCP-сервер позволяет вашему ИИ-агенту искать, сортировать, систематизировать и анализировать все, что вы сохранили.

Быстрый старт

1. Получите токен

Скачайте Burn для iOS или используйте Burn в браузере → Settings → MCP Server → Copy Access Token

2. Выберите режим подключения

2a. Локально — stdio (Claude Desktop / Claude Code CLI / Cursor / Windsurf)

{
  "mcpServers": {
    "burn": {
      "command": "npx",
      "args": ["burn-mcp-server"],
      "env": {
        "BURN_MCP_TOKEN": "<your-token>"
      }
    }
  }
}

2b. Удаленно — HTTPS (claude.ai Connectors / Claude Code Routines / любой облачный MCP-клиент)

Эндпоинт:

https://burn-mcp-server.vercel.app/api/mcp

Авторизация: заголовок Authorization: Bearer <BURN_MCP_TOKEN>.

Для claude.ai Connectors (Settings → Connectors → Add custom MCP):

URL: https://burn-mcp-server.vercel.app/api/mcp
Header: Authorization: Bearer <ваш BURN_MCP_TOKEN>

Для Claude Code Routines: добавьте глобально в Settings → Connectors; Routines автоматически включат его.

Прямой тест через curl:

curl -X POST https://burn-mcp-server.vercel.app/api/mcp \
  -H "Authorization: Bearer $BURN_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

Транспорт: stateless StreamableHTTP, режим JSON-ответов. Те же 26 инструментов, тот же токен, никакой установки.

3. Начните задавать вопросы

"Что я сохранил по системному дизайну?"
"Разбери мой Flame — что стоит оставить?"
"Создай коллекцию из моих закладок по ИИ"

Инструменты (26)

Поиск и чтение

Инструмент	Что делает
`search_vault`	Поиск в постоянных закладках по ключевым словам
`list_vault`	Список закладок в Хранилище по категориям
`list_sparks`	Список недавно прочитанных закладок (окно 30 дней)
`search_sparks`	Поиск в Искрах по ключевым словам
`list_flame`	Список входящих — что скоро сгорит
`get_flame_detail`	Полная информация о закладке в Flame
`get_bookmark`	Получить любую закладку по ID
`get_article_content`	Получить полный текст статьи + анализ
`fetch_content`	Получить контент по URL (X, Reddit, YouTube, WeChat)
`list_categories`	Все категории Хранилища с количеством элементов
`get_collections`	Список всех коллекций
`get_collection_overview`	Детали коллекции с ИИ-обзором

Сортировка (Агент как ваш фильтр)

Инструмент	Что делает
`move_flame_to_spark`	Оставить — стоит прочтения. Опционально: инсайт.
`move_flame_to_ash`	Сжечь. Опционально: причина.
`move_spark_to_vault`	Переместить в постоянное хранилище. Опционально: категория.
`move_spark_to_ash`	Недостаточно ценно для хранения.
`batch_triage_flame`	Сортировка до 20 элементов за раз.

Коллекции (Агент как ваш куратор)

Инструмент	Что делает
`create_collection`	Создать тематическую подборку с начальными закладками
`add_to_collection`	Добавить закладки (удаляет дубликаты)
`remove_from_collection`	Удалить закладки
`update_collection_overview`	Написать ИИ-обзор (тема, синтез, пробелы)

Анализ (Агент как ваш аналитик)

Инструмент	Что делает
`write_bookmark_analysis`	Записать структурированный анализ обратно в закладку

Авто-лента (Агент как ваш разведчик)

Инструмент	Что делает
`add_watched_source`	Отслеживать пользователя X, RSS-ленту или YouTube-канал. Новые посты автоматически попадают в Flame.
`list_watched_sources`	Список всех активных отслеживаемых источников
`remove_watched_source`	Прекратить отслеживание источника
`scrape_watched_sources`	Получить новый контент из отслеживаемых источников по запросу

Ресурсы

URI	Контент
`burn://vault/bookmarks`	Все закладки Хранилища (JSON)
`burn://vault/categories`	Список категорий (JSON)

Варианты использования

Управление личными знаниями — Ваш агент ищет по истории чтения, чтобы отвечать на вопросы, находить закономерности и поднимать забытые жемчужины.

Исследовательские рабочие процессы — Создавайте коллекции по темам, которые вы изучаете. Агент пишет обзоры, синтезируя ваши источники.

Сортировка чтения — Агент просматривает ваш входящий Flame, читает контент и решает, что стоит сохранить, основываясь на ваших интересах.

Интеллект между инструментами — Используйте с Claude Code, Cursor или Windsurf. Ваши закладки становятся контекстом для программирования, написания текстов и размышлений.

Переменные окружения

Переменная	Обязательно	Описание
`BURN_MCP_TOKEN`	Да*	Долгоживущий токен MCP (рекомендуется)
`BURN_SUPABASE_TOKEN`	Да*	Устаревший JWT-токен (все еще поддерживается)
`BURN_API_URL`	Нет	Пользовательский URL API (по умолчанию: production)

*Требуется либо BURN_MCP_TOKEN, либо BURN_SUPABASE_TOKEN.

Безопасность

Токен ограничен только вашими данными (Row Level Security)
Принудительный поток статусов: Flame → Spark → Vault, или → Ash
Лимит запросов: 30 вызовов/мин на сессию
Токены истекают через 30 дней

Ссылки

Приложение: burn451.cloud
iOS App: App Store
npm: burn-mcp-server
Chrome Extension: Ищите "Bookmark Autopsy" в Chrome Web Store

Лицензия

MIT

burn-mcp-server