Burn — 个人知识库 MCP 服务器

npm version License: MIT

将您的阅读数据转化为 AI 可访问的知识库。为 Claude、Cursor、Windsurf 及任何兼容 MCP 的智能体提供 26 个工具。

工作原理

Burn 通过 24 小时计时器对您的阅读内容进行分类：

Flame（火焰） → 新链接。24 小时内阅读，否则销毁。
Spark（火花） → 已阅读。保留 30 天。
Vault（保险库） → 永久保存。您精心挑选的知识。
Ash（灰烬） → 已过期。它们已经错过了机会。

该 MCP 服务器允许您的 AI 智能体搜索、分类、整理和分析您保存的所有内容。

快速入门

1. 获取您的令牌

下载 iOS 版 Burn 或使用 Burn 网页版 → 设置 → MCP 服务器 → 复制访问令牌

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（设置 → Connectors → 添加自定义 MCP）：

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

对于 Claude Code Routines：在“设置”→“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"}}}'

传输：无状态 StreamableHTTP，JSON 响应模式。相同的 26 个工具，相同的令牌，无需安装。

3. 开始提问

“我保存了哪些关于系统设计的资料？”
“整理我的 Flame — 我应该保留什么？”
“从我的 AI 书签中创建一个合集”

工具 (26)

搜索与阅读

工具	功能
`search_vault`	按关键词搜索永久书签
`list_vault`	按类别列出保险库书签
`list_sparks`	列出最近阅读的书签（30 天窗口期）
`search_sparks`	按关键词搜索 Sparks
`list_flame`	列出收件箱 — 即将销毁的内容
`get_flame_detail`	获取 Flame 书签的详细信息
`get_bookmark`	通过 ID 获取任何书签
`get_article_content`	获取文章全文及分析
`fetch_content`	从 URL 获取内容（X、Reddit、YouTube、微信）
`list_categories`	所有带有计数的保险库类别
`get_collections`	列出所有合集
`get_collection_overview`	带有 AI 概览的合集详情

分类（智能体作为您的过滤器）

工具	功能
`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`	编写 AI 概览（主题、综合、缺口）

分析（智能体作为您的分析师）

工具	功能
`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`	否	自定义 API URL（默认：生产环境）

*必须提供 BURN_MCP_TOKEN 或 BURN_SUPABASE_TOKEN 其中之一。

安全性

令牌仅限于访问您的数据（行级安全性）
强制执行状态流：Flame → Spark → Vault，或 → Ash
速率限制：每会话 30 次调用/分钟
令牌 30 天后过期

链接

应用: burn451.cloud
iOS 应用: App Store
npm: burn-mcp-server
Chrome 扩展: 在 Chrome 网上应用店搜索 "Bookmark Autopsy"

许可证

MIT

burn-mcp-server