reflect-mcp 1.0.1 → 1.0.2

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 +78 -0
  2. package/package.json +4 -3
package/README.md ADDED
@@ -0,0 +1,78 @@
1
+ # Reflect MCP Server
2
+
3
+ Connect your [Reflect](https://reflect.app) notes to Claude Desktop.
4
+
5
+ ## Quick Start
6
+
7
+ **1. Install the server:**
8
+ ```bash
9
+ npx reflect-mcp install
10
+ ```
11
+
12
+ **2. Add to Claude Desktop config** (`~/Library/Application Support/Claude/claude_desktop_config.json`):
13
+ ```json
14
+ {
15
+ "mcpServers": {
16
+ "reflect": {
17
+ "command": "npx",
18
+ "args": ["-y", "mcp-remote", "http://localhost:3000/mcp"]
19
+ }
20
+ }
21
+ }
22
+ ```
23
+
24
+ **3. Restart Claude Desktop**
25
+
26
+ That's it! First time you use a Reflect tool, your browser will open to authenticate.
27
+
28
+ ## Commands
29
+
30
+ ```bash
31
+ reflect-mcp install [db-path] # Install as auto-start service
32
+ reflect-mcp uninstall # Remove auto-start service
33
+ reflect-mcp status # Check service status
34
+ reflect-mcp [db-path] # Run server manually
35
+ ```
36
+
37
+ ## Options
38
+
39
+ | Option | Description | Default |
40
+ |--------|-------------|---------|
41
+ | `db-path` | Path to Reflect SQLite database | `~/Library/Application Support/Reflect/File System/000/t/00/00000000` |
42
+ | `--port <port>` | Server port | `3000` |
43
+
44
+ ## Examples
45
+
46
+ ```bash
47
+ # Install with default settings
48
+ npx reflect-mcp install
49
+
50
+ # Install with custom database path
51
+ npx reflect-mcp install ~/custom/path/to/reflect/db
52
+
53
+ # Install with custom port
54
+ npx reflect-mcp install --port 4000
55
+
56
+ # Check if service is running
57
+ npx reflect-mcp status
58
+
59
+ # Remove auto-start
60
+ npx reflect-mcp uninstall
61
+ ```
62
+
63
+ ## Tools Available
64
+
65
+ - `get_graphs` - List all Reflect graphs
66
+ - `get_backlinks` - Get backlinks for a note
67
+ - `get_daily_notes` - Get recent daily notes
68
+ - `get_daily_note_by_date` - Get daily note for specific date
69
+ - `get_backlinked_notes` - Get notes with most backlinks
70
+ - `get_tags` - Get all tags with usage counts
71
+ - `get_notes_with_tag` - Get notes with a specific tag
72
+ - `get_note` - Get a note by title
73
+ - `create_note` - Create a new note
74
+
75
+ ## License
76
+
77
+ MIT
78
+
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "reflect-mcp",
3
- "version": "1.0.1",
3
+ "version": "1.0.2",
4
4
  "description": "MCP server for Reflect Notes - connect your notes to Claude Desktop. Just run: npx reflect-mcp",
5
5
  "type": "module",
6
6
  "main": "dist/server.js",
@@ -15,7 +15,8 @@
15
15
  "build": "tsc",
16
16
  "dev": "tsx src/cli.ts",
17
17
  "start": "node dist/cli.js",
18
- "prepublishOnly": "npm run build"
18
+ "prepublishOnly": "npm run build",
19
+ "postinstall": "npm rebuild better-sqlite3 || true"
19
20
  },
20
21
  "keywords": [
21
22
  "mcp",
@@ -36,7 +37,7 @@
36
37
  },
37
38
  "dependencies": {
38
39
  "@modelcontextprotocol/sdk": "^1.25.1",
39
- "better-sqlite3": "^11.0.0",
40
+ "better-sqlite3": "^11.10.0",
40
41
  "fastmcp": "^3.25.4",
41
42
  "zod": "^4.1.13"
42
43
  },