reflect-mcp 1.0.3 → 1.0.5

package/README.md

@@ -125,8 +125,6 @@ npx reflect-mcp uninstall
 - Verify database path exists at default location
 - Try specifying custom path: `npx reflect-mcp install /path/to/db`
 
-## Demo:
-https://www.loom.com/share/455b1d3eb7184bdea1ae4e8d5904fc53
 ## License
 
 MIT

package/dist/server.js

@@ -63,7 +63,6 @@ export async function startReflectMCPServer(config) {
     await server.start({
         httpStream: {
             port,
-            stateless: true,
         },
         transportType: "httpStream",
     });

package/dist/tools/index.js

@@ -11,7 +11,7 @@ export function registerTools(server, dbPath) {
     // Tool: Get all Reflect graphs
     server.addTool({
         name: "get_graphs",
-        description: "Get a list of all Reflect graphs.",
+        description: "Get a list of all Reflect graphs accessible with the current access token",
         parameters: z.object({}),
         execute: async (_args, { session }) => {
             if (!session) {
@@ -59,7 +59,7 @@ export function registerTools(server, dbPath) {
     // Tool: Get backlinks for a note from local Reflect SQLite database
     server.addTool({
         name: "get_backlinks",
-        description: "Get backlinks for a note from Reflect. Use  this tool to get more context about a note after calling the get_note tool.",
+        description: "Get backlinks for a note from the local Reflect database. Returns notes that link to the specified note.",
         parameters: z.object({
             subject: z.string().describe("The subject/title of the note to get backlinks for"),
             graphId: z.string().default("rapheal-brain").describe("The graph ID to search in"),
@@ -111,7 +111,7 @@ export function registerTools(server, dbPath) {
     // Tool: Get recent daily notes
     server.addTool({
         name: "get_daily_notes",
-        description: "Get the most recent daily notes from Reflect.",
+        description: "Get the most recent daily notes from the local Reflect database",
         parameters: z.object({
             limit: z.number().default(5).describe("Number of recent daily notes to return"),
             graphId: z.string().default("rapheal-brain").describe("The graph ID to search in"),
@@ -163,7 +163,7 @@ export function registerTools(server, dbPath) {
     // Tool: Get daily note by date
     server.addTool({
         name: "get_daily_note_by_date",
-        description: "Get the daily note for a specific date.",
+        description: "Get the daily note for a specific date from the local Reflect database",
         parameters: z.object({
             date: z.string().describe("The date in YYYY-MM-DD format"),
             graphId: z.string().default("rapheal-brain").describe("The graph ID to search in"),
@@ -225,7 +225,7 @@ export function registerTools(server, dbPath) {
     // Tool: Get notes with most backlinks
     server.addTool({
         name: "get_backlinked_notes",
-        description: "Get notes that have at least a minimum number of backlinks from Reflect.",
+        description: "Get notes that have at least a minimum number of backlinks from the local Reflect database",
         parameters: z.object({
             minBacklinks: z.number().default(5).describe("Minimum number of backlinks a note must have"),
             limit: z.number().default(10).describe("Maximum number of notes to return"),
@@ -278,7 +278,7 @@ export function registerTools(server, dbPath) {
     // Tool: Get all tags with usage counts
     server.addTool({
         name: "get_tags",
-        description: "Get all unique tags with their usage counts from Reflect.",
+        description: "Get all unique tags with their usage counts from the local Reflect database",
         parameters: z.object({
             graphId: z.string().default("rapheal-brain").describe("The graph ID to search in"),
             limit: z.number().default(50).describe("Maximum number of tags to return"),
@@ -334,7 +334,7 @@ export function registerTools(server, dbPath) {
     // Tool: Get notes with a specific tag
     server.addTool({
         name: "get_notes_with_tag",
-        description: "Get notes that have a specific tag from Reflect.",
+        description: "Get notes that have a specific tag from the local Reflect database",
         parameters: z.object({
             tag: z.string().describe("The tag to search for"),
             graphId: z.string().default("rapheal-brain").describe("The graph ID to search in"),
@@ -383,116 +383,49 @@ export function registerTools(server, dbPath) {
             }
         },
     });
-    // Tool: Get a note by title (exact match first, then fuzzy fallback)
+    // Tool: Get a note by title
     server.addTool({
         name: "get_note",
-        description: "Get a note by its title (subject) from Reflect.",
+        description: "Get a note by its title (subject) from the local Reflect database",
         parameters: z.object({
             title: z.string().describe("The title/subject of the note to retrieve"),
             graphId: z.string().default("rapheal-brain").describe("The graph ID to search in"),
         }),
         execute: async (args) => {
             const { title, graphId } = args;
-            const FUZZY_LIMIT = 3;
             try {
                 const dbFile = resolvedDbPath;
                 const db = new Database(dbFile, { readonly: true });
-                // Try exact match first
-                const exactStmt = db.prepare(`
+                const stmt = db.prepare(`
           SELECT id, subject, documentText, tags, editedAt, createdAt
           FROM notes 
           WHERE isDeleted = 0 AND graphId = ? AND subject = ?
         `);
-                const exactResult = exactStmt.get(graphId, title);
-                if (exactResult) {
-                    db.close();
-                    const note = {
-                        id: exactResult.id,
-                        subject: exactResult.subject,
-                        documentText: exactResult.documentText,
-                        tags: exactResult.tags ? JSON.parse(exactResult.tags) : [],
-                        editedAt: formatDate(exactResult.editedAt),
-                        createdAt: formatDate(exactResult.createdAt),
-                    };
-                    return {
-                        content: [
-                            {
-                                type: "text",
-                                text: JSON.stringify({ title, graphId, note }, null, 2),
-                            },
-                        ],
-                    };
-                }
-                // No exact match - try fuzzy search
-                const searchTerm = title.toLowerCase();
-                const fuzzyStmt = db.prepare(`
-          SELECT id, subject, documentText, tags, editedAt, createdAt,
-            CASE 
-              WHEN LOWER(subject) LIKE ? THEN 2
-              WHEN LOWER(subject) LIKE ? THEN 1
-              ELSE 0
-            END as relevance
-          FROM notes 
-          WHERE isDeleted = 0 
-            AND graphId = ? 
-            AND (LOWER(subject) LIKE ? OR LOWER(subject) LIKE ?)
-          ORDER BY relevance DESC, editedAt DESC
-          LIMIT ?
-        `);
-                const fuzzyResults = fuzzyStmt.all(`${searchTerm}%`, // starts with (score 2)
-                `%${searchTerm}%`, // contains (score 1)
-                graphId, `${searchTerm}%`, // WHERE starts with
-                `%${searchTerm}%`, // WHERE contains
-                FUZZY_LIMIT);
+                const result = stmt.get(graphId, title);
                 db.close();
-                if (fuzzyResults.length === 0) {
+                if (!result) {
                     return {
                         content: [
                             {
                                 type: "text",
-                                text: JSON.stringify({
-                                    error: `No notes found matching '${title}'`,
-                                    query: title,
-                                    graphId
-                                }),
+                                text: JSON.stringify({ error: `Note '${title}' not found`, title, graphId }),
                             },
                         ],
                     };
                 }
-                const notes = fuzzyResults.map((result) => ({
+                const note = {
                     id: result.id,
                     subject: result.subject,
                     documentText: result.documentText,
                     tags: result.tags ? JSON.parse(result.tags) : [],
                     editedAt: formatDate(result.editedAt),
                     createdAt: formatDate(result.createdAt),
-                }));
-                // If only one fuzzy match, return it directly
-                if (notes.length === 1) {
-                    return {
-                        content: [
-                            {
-                                type: "text",
-                                text: JSON.stringify({
-                                    query: title,
-                                    graphId,
-                                    note: notes[0],
-                                    matchType: "fuzzy"
-                                }, null, 2),
-                            },
-                        ],
-                    };
-                }
+                };
                 return {
                     content: [
                         {
                             type: "text",
-                            text: JSON.stringify({
-                                query: title,
-                                graphId,
-                                matchCount: notes.length,
-                                notes
-                            }, null, 2),
+                            text: JSON.stringify({ title, graphId, note }, null, 2),
                         },
                     ],
                 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reflect-mcp",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "MCP server for Reflect Notes - connect your notes to Claude Desktop. Just run: npx reflect-mcp",
   "type": "module",
   "main": "dist/server.js",
@@ -15,8 +15,7 @@
     "build": "tsc",
     "dev": "tsx src/cli.ts",
     "start": "node dist/cli.js",
-    "prepublishOnly": "npm run build",
-    "postinstall": "npm rebuild better-sqlite3 || true"
+    "prepublishOnly": "npm run build"
   },
   "keywords": [
     "mcp",
@@ -37,7 +36,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.1",
-    "better-sqlite3": "^11.10.0",
+    "better-sqlite3": "^11.0.0",
     "fastmcp": "^3.25.4",
     "zod": "^4.1.13"
   },