Burn — MCP-Server für Ihre persönliche Wissensdatenbank

npm version License: MIT

Ihre Lese-Daten als KI-gestützte Wissensdatenbank. 26 Tools für Claude, Cursor, Windsurf und jeden anderen MCP-kompatiblen Agenten.

Funktionsweise

Burn sortiert Ihre Lektüre mit einem 24-Stunden-Timer:

Flame → Neue Links. 24 Stunden Zeit zum Lesen, sonst werden sie gelöscht.
Spark → Gelesen. Bleibt 30 Tage erhalten.
Vault → Permanent. Ihr kuratiertes Wissen.
Ash → Abgelaufen. Die Zeit ist abgelaufen.

Der MCP-Server ermöglicht es Ihrem KI-Agenten, alles, was Sie gespeichert haben, zu durchsuchen, zu sortieren, zu organisieren und zu analysieren.

Schnellstart

1. Token abrufen

Laden Sie Burn für iOS herunter oder nutzen Sie Burn im Web → Einstellungen → MCP-Server → Zugriffs-Token kopieren

2. Verbindungsmodus wählen

2a. Lokal — stdio (Claude Desktop / Claude Code CLI / Cursor / Windsurf)

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

2b. Remote — HTTPS (claude.ai Connectors / Claude Code Routines / beliebige Cloud-MCP-Clients)

Endpunkt:

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

Authentifizierung: Authorization: Bearer <BURN_MCP_TOKEN> Header.

Für claude.ai Connectors (Einstellungen → Connectors → Benutzerdefiniertes MCP hinzufügen):

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

Für Claude Code Routines: Global verknüpfen unter Einstellungen → Connectors; Routines binden es automatisch ein.

Direkter curl-Test:

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"}}}'

Transport: zustandsloses StreamableHTTP, JSON-Antwortmodus. Dieselben 26 Tools, dasselbe Token, keine Installation erforderlich.

3. Fragen stellen

„Was habe ich zum Thema Systemdesign gespeichert?“
„Sortiere meine Flame-Liste – was sollte ich behalten?“
„Erstelle eine Sammlung aus meinen KI-Lesezeichen“

Tools (26)

Suchen & Lesen

Tool	Funktion
`search_vault`	Permanente Lesezeichen nach Stichwort durchsuchen
`list_vault`	Vault-Lesezeichen nach Kategorie auflisten
`list_sparks`	Kürzlich gelesene Lesezeichen auflisten (30-Tage-Fenster)
`search_sparks`	Sparks nach Stichwort durchsuchen
`list_flame`	Posteingang auflisten – was kurz vor dem Löschen steht
`get_flame_detail`	Volle Details zu einem Flame-Lesezeichen
`get_bookmark`	Lesezeichen per ID abrufen
`get_article_content`	Vollständigen Artikelinhalt + Analyse abrufen
`fetch_content`	Inhalt von einer URL abrufen (X, Reddit, YouTube, WeChat)
`list_categories`	Alle Vault-Kategorien mit Anzahl
`get_collections`	Alle Sammlungen auflisten
`get_collection_overview`	Sammlungsdetails mit KI-Übersicht

Triage (Agent als Filter)

Tool	Funktion
`move_flame_to_spark`	Behalten – lesenswert. Optionale Erkenntnis.
`move_flame_to_ash`	Löschen. Optionaler Grund.
`move_spark_to_vault`	In permanenten Status befördern. Optionale Kategorie.
`move_spark_to_ash`	Nicht wertvoll genug zum Behalten.
`batch_triage_flame`	Bis zu 20 Elemente gleichzeitig sortieren.

Sammlungen (Agent als Kurator)

Tool	Funktion
`create_collection`	Themenbündel mit ersten Lesezeichen erstellen
`add_to_collection`	Lesezeichen hinzufügen (mit Deduplizierung)
`remove_from_collection`	Lesezeichen entfernen
`update_collection_overview`	KI-Übersicht schreiben (Thema, Synthese, Lücken)

Analyse (Agent als Analyst)

Tool	Funktion
`write_bookmark_analysis`	Strukturierte Analyse in einem Lesezeichen speichern

Auto-Feed (Agent als Scout)

Tool	Funktion
`add_watched_source`	X-Nutzer, RSS-Feed oder YouTube-Kanal beobachten. Neue Beiträge landen automatisch in Flame.
`list_watched_sources`	Alle aktiven beobachteten Quellen auflisten
`remove_watched_source`	Beobachtung einer Quelle beenden
`scrape_watched_sources`	Neue Inhalte von beobachteten Quellen bei Bedarf abrufen

Ressourcen

URI	Inhalt
`burn://vault/bookmarks`	Alle Vault-Lesezeichen (JSON)
`burn://vault/categories`	Kategorieliste (JSON)

Anwendungsfälle

Persönliches Wissensmanagement — Ihr Agent durchsucht Ihre Lesehistorie, um Fragen zu beantworten, Muster zu finden und vergessene Schätze wiederzufinden.

Forschungs-Workflows — Erstellen Sie Sammlungen zu Themen, die Sie erforschen. Der Agent schreibt Übersichten, die Ihre Quellen zusammenfassen.

Lese-Triage — Der Agent überprüft Ihren Flame-Posteingang, liest die Inhalte und entscheidet basierend auf Ihren Interessen, was behalten werden sollte.

Intelligenz über Tools hinweg — Nutzen Sie es mit Claude Code, Cursor oder Windsurf. Ihre Lesezeichen werden zum Kontext für Programmierung, Schreiben und Denken.

Umgebungsvariablen

Variable	Erforderlich	Beschreibung
`BURN_MCP_TOKEN`	Ja*	Langlebiges MCP-Token (empfohlen)
`BURN_SUPABASE_TOKEN`	Ja*	Legacy-JWT-Token (wird noch unterstützt)
`BURN_API_URL`	Nein	Benutzerdefinierte API-URL (Standard: Produktion)

*Entweder BURN_MCP_TOKEN oder BURN_SUPABASE_TOKEN ist erforderlich.

Sicherheit

Token nur auf Ihre Daten beschränkt (Row Level Security)
Status-Flow erzwungen: Flame → Spark → Vault oder → Ash
Ratenbegrenzung: 30 Aufrufe/Min. pro Sitzung
Token laufen nach 30 Tagen ab

Lizenz

MIT

burn-mcp-server