burn-mcp-server 2.0.0 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +68 -61
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,16 +1,24 @@
1
- # Burn MCP Server
1
+ # Burn — Personal Knowledge Base MCP Server
2
2
 
3
- Let Claude Desktop, Cursor, or any MCP-compatible AI tool access and manage your Burn bookmarks.
3
+ Your reading data as an AI-accessible knowledge base. 22 tools for Claude, Cursor, Windsurf, and any MCP-compatible agent.
4
4
 
5
- ## Setup
5
+ ## How it works
6
6
 
7
- ### 1. Get your access token
7
+ Burn triages your reading with a 24h timer:
8
+ - **Flame** → New links. 24h to read or they burn.
9
+ - **Spark** → You read it. Stays 30 days.
10
+ - **Vault** → Permanent. Your curated knowledge.
11
+ - **Ash** → Expired. They had their chance.
8
12
 
9
- Open Burn App → Settings → MCP Server → **Copy Access Token**
13
+ The MCP server lets your AI agent search, triage, organize, and analyze everything you've saved.
14
+
15
+ ## Quick Start
16
+
17
+ ### 1. Get your token
10
18
 
11
- ### 2. Configure Claude Desktop
19
+ Open Burn App → Settings → MCP Server → **Copy Access Token**
12
20
 
13
- Add to your `~/.config/claude/claude_desktop_config.json`:
21
+ ### 2. Add to Claude Desktop
14
22
 
15
23
  ```json
16
24
  {
@@ -19,86 +27,79 @@ Add to your `~/.config/claude/claude_desktop_config.json`:
19
27
  "command": "npx",
20
28
  "args": ["burn-mcp-server"],
21
29
  "env": {
22
- "BURN_MCP_TOKEN": "<paste-your-token-here>"
30
+ "BURN_MCP_TOKEN": "<your-token>"
23
31
  }
24
32
  }
25
33
  }
26
34
  }
27
35
  ```
28
36
 
29
- ### 3. Restart Claude Desktop
37
+ ### 3. Start asking
30
38
 
31
- The Burn tools will appear in the tools menu.
39
+ - "What did I save about system design?"
40
+ - "Triage my Flame — what should I keep?"
41
+ - "Create a collection from my AI bookmarks"
32
42
 
33
- ## Available Tools
43
+ ## Tools (22)
34
44
 
35
- ### Read Tools
45
+ ### Search & Read
36
46
 
37
- | Tool | Description |
47
+ | Tool | What it does |
38
48
  |------|-------------|
39
- | `search_vault` | Search Vault bookmarks by keyword |
40
- | `list_vault` | List Vault bookmarks, optionally by category |
41
- | `list_sparks` | List Sparks (read bookmarks with 30-day lifespan) |
49
+ | `search_vault` | Search permanent bookmarks by keyword |
50
+ | `list_vault` | List Vault bookmarks by category |
51
+ | `list_sparks` | List recently read bookmarks (30-day window) |
42
52
  | `search_sparks` | Search Sparks by keyword |
43
- | `list_flame` | List Flame inbox (24h countdown, AI triage info) |
44
- | `get_flame_detail` | Get full Flame bookmark detail with content |
45
- | `get_bookmark` | Get full details of a single bookmark |
46
- | `get_article_content` | Get article content and AI analysis by ID |
47
- | `fetch_content` | Fetch content from a URL (X, Reddit, YouTube, WeChat, etc.) |
48
- | `list_categories` | List all Vault categories with counts |
53
+ | `list_flame` | List inbox — what's about to burn |
54
+ | `get_flame_detail` | Full detail on a Flame bookmark |
55
+ | `get_bookmark` | Get any bookmark by ID |
56
+ | `get_article_content` | Get full article content + analysis |
57
+ | `fetch_content` | Fetch content from a URL (X, Reddit, YouTube, WeChat) |
58
+ | `list_categories` | All Vault categories with counts |
49
59
  | `get_collections` | List all Collections |
50
- | `get_collection_overview` | Get a Collection with AI overview and bookmarks |
60
+ | `get_collection_overview` | Collection detail with AI overview |
51
61
 
52
- ### Write Tools — Layer 1: Status Flow (决策层)
62
+ ### Triage (Agent as your filter)
53
63
 
54
- | Tool | Description |
64
+ | Tool | What it does |
55
65
  |------|-------------|
56
- | `move_flame_to_spark` | Flame → Spark (worth reading). Sets 30-day lifespan. Optional `spark_insight`. |
57
- | `move_flame_to_ash` | Flame → Ash (burn it). Optional `reason`. |
58
- | `move_spark_to_vault` | Spark → Vault (permanent). Optional `vault_category`. |
59
- | `move_spark_to_ash` | Spark → Ash (not valuable enough to vault). |
60
- | `batch_triage_flame` | Triage up to 20 Flame bookmarks at once (spark or ash). |
66
+ | `move_flame_to_spark` | Keep it — worth reading. Optional insight. |
67
+ | `move_flame_to_ash` | Burn it. Optional reason. |
68
+ | `move_spark_to_vault` | Promote to permanent. Optional category. |
69
+ | `move_spark_to_ash` | Not valuable enough to keep. |
70
+ | `batch_triage_flame` | Triage up to 20 at once. |
61
71
 
62
- ### Write Tools — Layer 2: Collections (组合层)
72
+ ### Collections (Agent as your curator)
63
73
 
64
- | Tool | Description |
74
+ | Tool | What it does |
65
75
  |------|-------------|
66
- | `create_collection` | Create a new Collection, optionally with initial bookmarks. |
67
- | `add_to_collection` | Add bookmarks to a Collection (deduplicates). |
68
- | `remove_from_collection` | Remove bookmarks from a Collection. |
69
- | `update_collection_overview` | Write AI overview (theme, synthesis, patterns, gaps). |
76
+ | `create_collection` | Create a topic bundle with initial bookmarks |
77
+ | `add_to_collection` | Add bookmarks (deduplicates) |
78
+ | `remove_from_collection` | Remove bookmarks |
79
+ | `update_collection_overview` | Write AI overview (theme, synthesis, gaps) |
70
80
 
71
- ### Write Tools — Layer 3: AI Analysis (分析层)
81
+ ### Analysis (Agent as your analyst)
72
82
 
73
- | Tool | Description |
83
+ | Tool | What it does |
74
84
  |------|-------------|
75
- | `write_bookmark_analysis` | Write AI analysis back to a bookmark. Agent uses its own LLM to analyze, then writes structured results (summary, strategy, takeaways, relevance, novelty, tags) into Burn. |
85
+ | `write_bookmark_analysis` | Write structured analysis back to a bookmark |
76
86
 
77
- ## Available Resources
87
+ ## Resources
78
88
 
79
- | URI | Description |
80
- |-----|-------------|
89
+ | URI | Content |
90
+ |-----|---------|
81
91
  | `burn://vault/bookmarks` | All Vault bookmarks (JSON) |
82
92
  | `burn://vault/categories` | Category list (JSON) |
83
93
 
84
- ## Example Prompts
94
+ ## Use Cases
85
95
 
86
- **Reading:**
87
- - "What did I save about SwiftUI animations?"
88
- - "Show me my Flame inbox — what's about to burn?"
89
- - "Summarize my AI-related bookmarks"
96
+ **Personal knowledge management** — Your agent searches your reading history to answer questions, find patterns, and surface forgotten gems.
90
97
 
91
- **Triage (Agent as your filter):**
92
- - "Review my Flame bookmarks and decide what to keep vs burn"
93
- - "Triage everything in Flame — skim the content and make decisions"
98
+ **Research workflows** — Create collections on topics you're exploring. Agent writes overviews synthesizing your sources.
94
99
 
95
- **Analysis (Agent as your analyst):**
96
- - "Analyze this bookmark and write your assessment back to Burn"
97
- - "Go through my Sparks and tag them all"
100
+ **Reading triage** — Agent reviews your Flame inbox, reads the content, decides what's worth keeping based on your interests.
98
101
 
99
- **Collections (Agent as your curator):**
100
- - "Group my Vault bookmarks about AI into a collection"
101
- - "Write an overview for my 'System Design' collection"
102
+ **Cross-tool intelligence** — Use with Claude Code, Cursor, or Windsurf. Your bookmarks become context for coding, writing, and thinking.
102
103
 
103
104
  ## Environment Variables
104
105
 
@@ -108,11 +109,17 @@ The Burn tools will appear in the tools menu.
108
109
  | `BURN_SUPABASE_TOKEN` | Yes* | Legacy JWT token (still supported) |
109
110
  | `BURN_API_URL` | No | Custom API URL (default: production) |
110
111
 
111
- *One of `BURN_MCP_TOKEN` or `BURN_SUPABASE_TOKEN` is required.
112
+ *One of `BURN_MCP_TOKEN` or `BURN_SUPABASE_TOKEN` required.
112
113
 
113
114
  ## Security
114
115
 
115
- - Your token only grants access to **your own** data (enforced by Row Level Security)
116
- - Write operations are scoped: status can only flow forward (Flame → Spark → Vault, or → Ash)
117
- - Rate limited: 30 calls/minute per session
118
- - Tokens expire after 30 days; regenerate from Burn App → Settings → MCP Server
116
+ - Token scoped to your data only (Row Level Security)
117
+ - Status flow enforced: Flame → Spark → Vault, or → Ash
118
+ - Rate limit: 30 calls/min per session
119
+ - Tokens expire after 30 days
120
+
121
+ ## Links
122
+
123
+ - **App**: [burn451.app](https://burn451.app)
124
+ - **npm**: [burn-mcp-server](https://www.npmjs.com/package/burn-mcp-server)
125
+ - **Chrome Extension**: Search "Bookmark Autopsy" on Chrome Web Store
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "burn-mcp-server",
3
- "version": "2.0.0",
3
+ "version": "2.0.1",
4
4
  "description": "MCP Server for Burn — access your Vault from Claude/Cursor",
5
5
  "main": "dist/index.js",
6
6
  "bin": {