burn-mcp-server 2.0.7 → 2.1.0

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.
@@ -0,0 +1,19 @@
1
+ {
2
+ "name": "Burn MCP Server",
3
+ "description": "AI-powered reading triage — 26 tools for managing your reading queue with a 24h burn countdown. Save, search, digest, and triage articles from Claude or Cursor.",
4
+ "version": "2.0.6",
5
+ "homepage": "https://burn451.cloud",
6
+ "license": "MIT",
7
+ "keywords": [
8
+ "mcp",
9
+ "reading",
10
+ "productivity",
11
+ "knowledge-management",
12
+ "bookmark",
13
+ "ai-tools"
14
+ ],
15
+ "author": {
16
+ "name": "Burn451",
17
+ "url": "https://github.com/Fisher521"
18
+ }
19
+ }
package/.mcp.json ADDED
@@ -0,0 +1,11 @@
1
+ {
2
+ "mcpServers": {
3
+ "burn-mcp-server": {
4
+ "command": "npx",
5
+ "args": ["-y", "burn-mcp-server"],
6
+ "env": {
7
+ "BURN_API_KEY": "<your-burn-api-key>"
8
+ }
9
+ }
10
+ }
11
+ }
package/README.md CHANGED
@@ -21,35 +21,9 @@ The MCP server lets your AI agent search, triage, organize, and analyze everythi
21
21
 
22
22
  Download [Burn on iOS](https://apps.apple.com/app/burn451/id6759418544) or use [Burn on the web](https://burn451.cloud) → Settings → MCP Server → **Copy Access Token**
23
23
 
24
- ### 2. Connect (pick one)
24
+ ### 2. Pick a connection mode
25
25
 
26
- #### Option ARemote HTTP (recommended, no install)
27
-
28
- Add this URL to your MCP client. Works with Claude Desktop, Cursor, Windsurf, ChatGPT desktop, anything that speaks MCP Streamable HTTP:
29
-
30
- ```
31
- https://mcp.burn451.cloud/mcp
32
- ```
33
-
34
- Authorization header: `Bearer <your-token>`
35
-
36
- Claude Desktop config:
37
- ```json
38
- {
39
- "mcpServers": {
40
- "burn": {
41
- "url": "https://mcp.burn451.cloud/mcp",
42
- "headers": { "Authorization": "Bearer <your-token>" }
43
- }
44
- }
45
- }
46
- ```
47
-
48
- No Node install, no npx, no local process — one URL and you're in.
49
-
50
- #### Option B — Local stdio (npm install)
51
-
52
- For offline / privacy-sensitive setups where you don't want requests going through burn451.cloud:
26
+ #### 2a. Localstdio (Claude Desktop / Claude Code CLI / Cursor / Windsurf)
53
27
 
54
28
  ```json
55
29
  {
@@ -65,6 +39,33 @@ For offline / privacy-sensitive setups where you don't want requests going throu
65
39
  }
66
40
  ```
67
41
 
42
+ #### 2b. Remote — HTTPS (claude.ai Connectors / Claude Code Routines / any cloud MCP client)
43
+
44
+ Endpoint:
45
+
46
+ ```
47
+ https://burn-mcp-server.vercel.app/api/mcp
48
+ ```
49
+
50
+ Auth: `Authorization: Bearer <BURN_MCP_TOKEN>` header.
51
+
52
+ For **claude.ai Connectors** (Settings → Connectors → Add custom MCP):
53
+ - URL: `https://burn-mcp-server.vercel.app/api/mcp`
54
+ - Header: `Authorization: Bearer <your BURN_MCP_TOKEN>`
55
+
56
+ For **Claude Code Routines**: link globally in Settings → Connectors; Routines will auto-include it.
57
+
58
+ Direct curl test:
59
+
60
+ ```bash
61
+ curl -X POST https://burn-mcp-server.vercel.app/api/mcp \
62
+ -H "Authorization: Bearer $BURN_MCP_TOKEN" \
63
+ -H "Content-Type: application/json" \
64
+ -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'
65
+ ```
66
+
67
+ Transport: stateless StreamableHTTP, JSON-response mode. Same 26 tools, same token, no install.
68
+
68
69
  ### 3. Start asking
69
70
 
70
71
  - "What did I save about system design?"
@@ -141,7 +142,7 @@ For offline / privacy-sensitive setups where you don't want requests going throu
141
142
 
142
143
  **Cross-tool intelligence** — Use with Claude Code, Cursor, or Windsurf. Your bookmarks become context for coding, writing, and thinking.
143
144
 
144
- ## Environment Variables (stdio mode)
145
+ ## Environment Variables
145
146
 
146
147
  | Variable | Required | Description |
147
148
  |----------|----------|-------------|
@@ -151,33 +152,6 @@ For offline / privacy-sensitive setups where you don't want requests going throu
151
152
 
152
153
  *One of `BURN_MCP_TOKEN` or `BURN_SUPABASE_TOKEN` required.
153
154
 
154
- ## Transports
155
-
156
- This server ships two transports from the same tool set:
157
-
158
- | Transport | Entry | Who it's for |
159
- |---|---|---|
160
- | **Streamable HTTP** (`src/http.ts` → `api/mcp.ts`) | Remote server (Vercel Edge) | Most users — paste one URL, done |
161
- | **stdio** (`src/index.ts`) | `npx burn-mcp-server` | Offline / privacy-first users |
162
-
163
- ### Self-hosting the HTTP server
164
-
165
- ```bash
166
- git clone https://github.com/Fisher521/burn-mcp-server
167
- cd burn-mcp-server
168
- npm install
169
- npm run build:http
170
- PORT=3791 node dist/http.mjs
171
- # test:
172
- curl -sS -X POST http://localhost:3791 \
173
- -H "Authorization: Bearer <YOUR_TOKEN>" \
174
- -H "Content-Type: application/json" \
175
- -H "Accept: application/json, text/event-stream" \
176
- -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'
177
- ```
178
-
179
- Or deploy to Vercel (one-click): `vercel --prod` in repo root. Config is in `vercel.json`.
180
-
181
155
  ## Security
182
156
 
183
157
  - Token scoped to your data only (Row Level Security)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "burn-mcp-server",
3
- "version": "2.0.7",
3
+ "version": "2.1.0",
4
4
  "mcpName": "io.github.Fisher521/burn-mcp-server",
5
5
  "description": "Burn MCP — give your AI agent a reading workflow. 26 tools to search, triage, burn, vault, and analyze your saved articles. Works with Claude, Cursor, Windsurf.",
6
6
  "main": "dist/index.js",
@@ -8,13 +8,9 @@
8
8
  "burn-mcp": "dist/index.js"
9
9
  },
10
10
  "scripts": {
11
- "build": "esbuild src/index.ts --bundle --platform=node --target=node18 --outfile=dist/index.js --format=cjs --packages=external",
12
- "build:http": "esbuild src/http-dev.ts --bundle --platform=node --target=node18 --outfile=dist/http.mjs --format=esm --packages=external",
13
- "build:vercel": "esbuild src/vercel-node-handler.ts --bundle --platform=node --target=node20 --outfile=api/mcp.js --format=cjs",
14
- "build:all": "npm run build && npm run build:http && npm run build:vercel",
11
+ "build": "esbuild src/index.ts --bundle=false --platform=node --target=node18 --outdir=dist --format=cjs",
15
12
  "typecheck": "node --max-old-space-size=4096 node_modules/typescript/bin/tsc --noEmit",
16
- "start": "node dist/index.js",
17
- "dev:http": "npm run build:http && node dist/http.mjs"
13
+ "start": "node dist/index.js"
18
14
  },
19
15
  "keywords": [
20
16
  "mcp",
package/server.json CHANGED
@@ -7,12 +7,12 @@
7
7
  "source": "github"
8
8
  },
9
9
  "websiteUrl": "https://burn451.cloud",
10
- "version": "2.0.7",
10
+ "version": "2.1.0",
11
11
  "packages": [
12
12
  {
13
13
  "registryType": "npm",
14
14
  "identifier": "burn-mcp-server",
15
- "version": "2.0.7",
15
+ "version": "2.1.0",
16
16
  "transport": {
17
17
  "type": "stdio"
18
18
  },
@@ -30,11 +30,11 @@
30
30
  "remotes": [
31
31
  {
32
32
  "type": "streamable-http",
33
- "url": "https://burn-mcp-server.vercel.app/mcp",
33
+ "url": "https://burn-mcp-server.vercel.app/api/mcp",
34
34
  "headers": [
35
35
  {
36
36
  "name": "Authorization",
37
- "description": "Bearer <BURN_MCP_TOKEN> — get your token at https://burn451.cloud → Settings → MCP Server",
37
+ "description": "Bearer <BURN_MCP_TOKEN> — generate at https://burn451.cloud → Settings → MCP Server",
38
38
  "isRequired": true,
39
39
  "isSecret": true
40
40
  }