Burn — Servidor MCP de base de conocimientos personal

npm version License: MIT

Tus datos de lectura como una base de conocimientos accesible para IA. 26 herramientas para Claude, Cursor, Windsurf y cualquier agente compatible con MCP.

Cómo funciona

Burn clasifica tus lecturas con un temporizador de 24 horas:

Flame (Llama) → Nuevos enlaces. 24 horas para leer o se eliminan.
Spark (Chispa) → Lo has leído. Se mantiene 30 días.
Vault (Bóveda) → Permanente. Tu conocimiento curado.
Ash (Ceniza) → Caducado. Tuvieron su oportunidad.

El servidor MCP permite que tu agente de IA busque, clasifique, organice y analice todo lo que has guardado.

Inicio rápido

1. Obtén tu token

Descarga Burn en iOS o usa Burn en la web → Ajustes → Servidor MCP → Copiar token de acceso

2. Elige un modo de conexión

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

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

2b. Remoto — HTTPS (Conectores de claude.ai / Rutinas de Claude Code / cualquier cliente MCP en la nube)

Endpoint:

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

Autenticación: cabecera Authorization: Bearer <BURN_MCP_TOKEN>.

Para Conectores de claude.ai (Ajustes → Conectores → Añadir MCP personalizado):

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

Para Rutinas de Claude Code: vincular globalmente en Ajustes → Conectores; las rutinas lo incluirán automáticamente.

Prueba directa con 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"}}}'

Transporte: StreamableHTTP sin estado, modo de respuesta JSON. Las mismas 26 herramientas, el mismo token, sin instalación.

3. Empieza a preguntar

"¿Qué he guardado sobre diseño de sistemas?"
"Clasifica mis Flame: ¿qué debería conservar?"
"Crea una colección a partir de mis marcadores de IA"

Herramientas (26)

Buscar y leer

Herramienta	Qué hace
`search_vault`	Busca marcadores permanentes por palabra clave
`list_vault`	Lista los marcadores de la Bóveda por categoría
`list_sparks`	Lista los marcadores leídos recientemente (ventana de 30 días)
`search_sparks`	Busca Sparks por palabra clave
`list_flame`	Lista la bandeja de entrada: lo que está a punto de eliminarse
`get_flame_detail`	Detalle completo de un marcador Flame
`get_bookmark`	Obtiene cualquier marcador por ID
`get_article_content`	Obtiene el contenido completo del artículo + análisis
`fetch_content`	Obtiene contenido de una URL (X, Reddit, YouTube, WeChat)
`list_categories`	Todas las categorías de la Bóveda con recuentos
`get_collections`	Lista todas las colecciones
`get_collection_overview`	Detalle de la colección con resumen de IA

Triaje (Agente como tu filtro)

Herramienta	Qué hace
`move_flame_to_spark`	Consérvalo: vale la pena leerlo. Perspectiva opcional.
`move_flame_to_ash`	Elimínalo. Motivo opcional.
`move_spark_to_vault`	Promocionar a permanente. Categoría opcional.
`move_spark_to_ash`	No es lo suficientemente valioso para conservarlo.
`batch_triage_flame`	Clasifica hasta 20 a la vez.

Colecciones (Agente como tu curador)

Herramienta	Qué hace
`create_collection`	Crea un paquete de temas con marcadores iniciales
`add_to_collection`	Añade marcadores (elimina duplicados)
`remove_from_collection`	Elimina marcadores
`update_collection_overview`	Escribe un resumen de IA (tema, síntesis, lagunas)

Análisis (Agente como tu analista)

Herramienta	Qué hace
`write_bookmark_analysis`	Escribe un análisis estructurado en un marcador

Auto-Feed (Agente como tu explorador)

Herramienta	Qué hace
`add_watched_source`	Observa un usuario de X, feed RSS o canal de YouTube. Las nuevas publicaciones fluyen a Flame automáticamente.
`list_watched_sources`	Lista todas las fuentes observadas activas
`remove_watched_source`	Deja de observar una fuente
`scrape_watched_sources`	Obtiene nuevo contenido de las fuentes observadas bajo demanda

Recursos

URI	Contenido
`burn://vault/bookmarks`	Todos los marcadores de la Bóveda (JSON)
`burn://vault/categories`	Lista de categorías (JSON)

Casos de uso

Gestión de conocimiento personal — Tu agente busca en tu historial de lectura para responder preguntas, encontrar patrones y sacar a la luz joyas olvidadas.

Flujos de trabajo de investigación — Crea colecciones sobre temas que estés explorando. El agente escribe resúmenes sintetizando tus fuentes.

Triaje de lectura — El agente revisa tu bandeja de entrada Flame, lee el contenido y decide qué vale la pena conservar según tus intereses.

Inteligencia entre herramientas — Úsalo con Claude Code, Cursor o Windsurf. Tus marcadores se convierten en contexto para programar, escribir y pensar.

Variables de entorno

Variable	Requerido	Descripción
`BURN_MCP_TOKEN`	Sí*	Token MCP de larga duración (recomendado)
`BURN_SUPABASE_TOKEN`	Sí*	Token JWT heredado (todavía compatible)
`BURN_API_URL`	No	URL de API personalizada (predeterminado: producción)

*Se requiere uno de BURN_MCP_TOKEN o BURN_SUPABASE_TOKEN.

Seguridad

Token limitado solo a tus datos (Seguridad a nivel de fila)
Flujo de estado aplicado: Flame → Spark → Vault, o → Ash
Límite de tasa: 30 llamadas/min por sesión
Los tokens caducan después de 30 días

Enlaces

App: burn451.cloud
App iOS: App Store
npm: burn-mcp-server
Extensión de Chrome: Busca "Bookmark Autopsy" en Chrome Web Store

Licencia

MIT

burn-mcp-server