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.
- package/.cursor-plugin/plugin.json +19 -0
- package/.mcp.json +11 -0
- package/README.md +30 -56
- package/package.json +3 -7
- package/server.json +4 -4
- package/src/index.ts +1624 -28
- package/tsconfig.json +6 -10
- package/vercel.json +7 -5
- package/api/health.mjs +0 -7
- package/public/index.html +0 -47
- package/src/http-dev.ts +0 -56
- package/src/http.ts +0 -62
- package/src/lib/auth-stdio.ts +0 -26
- package/src/lib/auth.ts +0 -71
- package/src/setup.ts +0 -1529
- package/src/vercel-handler.ts +0 -20
|
@@ -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
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.
|
|
24
|
+
### 2. Pick a connection mode
|
|
25
25
|
|
|
26
|
-
####
|
|
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. Local — stdio (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
|
|
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
|
|
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 --
|
|
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
|
|
10
|
+
"version": "2.1.0",
|
|
11
11
|
"packages": [
|
|
12
12
|
{
|
|
13
13
|
"registryType": "npm",
|
|
14
14
|
"identifier": "burn-mcp-server",
|
|
15
|
-
"version": "2.0
|
|
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> —
|
|
37
|
+
"description": "Bearer <BURN_MCP_TOKEN> — generate at https://burn451.cloud → Settings → MCP Server",
|
|
38
38
|
"isRequired": true,
|
|
39
39
|
"isSecret": true
|
|
40
40
|
}
|