@noesis-brain/mcp-server 2.0.0

package/dist/types/index.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Note types for md-manager MCP server
+ */
+export interface Note {
+    id: number;
+    title: string;
+    file_path: string;
+    content: string;
+    description?: string;
+    keywords?: string;
+    points?: number;
+    is_favorite?: number;
+    modified_at?: string;
+    created_at?: string;
+    hash?: string;
+    importance_score?: number;
+    quality_score?: number;
+    relations?: Relation[];
+}
+/**
+ * Document relation (Phase 6.2)
+ * Bidirectional: forward types have inverse counterparts
+ */
+export interface Relation {
+    type: RelationType;
+    target_id: number;
+    context?: string;
+}
+export type RelationType = 'references' | 'referenced_by' | 'implements' | 'implemented_by' | 'extends' | 'extended_by' | 'supersedes' | 'superseded_by';
+export interface SearchResult {
+    id: number;
+    title: string;
+    file_path: string;
+    content: string;
+    excerpt: string;
+    relevance: number;
+    modified_at?: string;
+}
+export interface SearchOptions {
+    limit?: number;
+    root?: string;
+    dateRange?: {
+        start: string;
+        end: string;
+    };
+}
+export interface SyncResult {
+    synced: number;
+    skipped: number;
+    errors: string[];
+    details: Array<{
+        file: string;
+        action: 'created' | 'updated' | 'skipped' | 'error';
+        reason?: string;
+        aiMetadata?: boolean;
+    }>;
+}
+/**
+ * Bidirectional sync result - tracks both push and pull operations
+ */
+export interface BidirectionalSyncResult {
+    pushed: {
+        created: number;
+        updated: number;
+    };
+    pulled: {
+        created: number;
+        updated: number;
+    };
+    skipped: number;
+    conflicts: Array<{
+        path: string;
+        localModified: string;
+        cloudModified: string;
+    }>;
+    errors: string[];
+    details: Array<{
+        file: string;
+        action: 'pushed_create' | 'pushed_update' | 'pulled_create' | 'pulled_update' | 'skipped' | 'conflict' | 'error';
+        reason?: string;
+    }>;
+}
+export interface SyncStatus {
+    pending: number;
+    lastSync: string | null;
+    roots: Array<{
+        name: string;
+        path: string;
+        fileCount: number;
+        lastScanned: string | null;
+    }>;
+}
+export interface LocalFile {
+    path: string;
+    relativePath: string;
+    content: string;
+    hash: string;
+    mtime: Date;
+    size: number;
+    rootId: number;
+    rootName: string;
+    project?: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/types/index.js

@@ -0,0 +1,5 @@
+/**
+ * Note types for md-manager MCP server
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/suggestPath.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Cross-platform default-path suggestion helper.
+ *
+ * NOTE: a near-identical copy lives in src/frontend/src/utils/osPlatform.ts.
+ * The two files are in separate npm packages with no shared util layer; if you
+ * change one, change the other.
+ *
+ * Used by the MCP `add_root` tool when the user supplies a path for one OS and
+ * we want to pre-fill the other side. Only emits a non-empty suggestion when
+ * the input is recognizably home-relative — otherwise returns '' so the caller
+ * leaves the other slot empty rather than guessing wrong.
+ */
+export type OsKey = 'win32' | 'darwin' | 'linux';
+export declare function suggestOtherOsPath(inputPath: string, sourceOs: OsKey): string;
+//# sourceMappingURL=suggestPath.d.ts.map

package/dist/utils/suggestPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestPath.d.ts","sourceRoot":"","sources":["../../src/utils/suggestPath.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEjD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,GAAG,MAAM,CAkC7E"}

package/dist/utils/suggestPath.js

@@ -0,0 +1,52 @@
+/**
+ * Cross-platform default-path suggestion helper.
+ *
+ * NOTE: a near-identical copy lives in src/frontend/src/utils/osPlatform.ts.
+ * The two files are in separate npm packages with no shared util layer; if you
+ * change one, change the other.
+ *
+ * Used by the MCP `add_root` tool when the user supplies a path for one OS and
+ * we want to pre-fill the other side. Only emits a non-empty suggestion when
+ * the input is recognizably home-relative — otherwise returns '' so the caller
+ * leaves the other slot empty rather than guessing wrong.
+ */
+export function suggestOtherOsPath(inputPath, sourceOs) {
+    if (typeof inputPath !== 'string')
+        return '';
+    const trimmed = inputPath.trim().replace(/[/\\]+$/, '');
+    if (!trimmed)
+        return '';
+    if (sourceOs === 'win32') {
+        // Only suggest if under %USERPROFILE% (the C:\Users\<x>\... convention).
+        const m = trimmed.match(/^[A-Za-z]:[\\/]Users[\\/][^\\/]+[\\/](.+)$/i);
+        if (!m)
+            return '';
+        const subpath = m[1].replace(/\\/g, '/');
+        return '~/' + subpath;
+    }
+    if (sourceOs === 'darwin' || sourceOs === 'linux') {
+        let subpath = null;
+        if (trimmed.startsWith('~/')) {
+            subpath = trimmed.slice(2);
+        }
+        else {
+            const mac = trimmed.match(/^\/Users\/[^/]+\/(.+)$/);
+            if (mac) {
+                subpath = mac[1];
+            }
+            else {
+                const lin = trimmed.match(/^\/home\/[^/]+\/(.+)$/);
+                if (lin)
+                    subpath = lin[1];
+            }
+        }
+        if (!subpath)
+            return '';
+        // %USERNAME% is a template token — caller must expand on first use.
+        // Leaving it literal signals "this is a guess, edit it" instead of
+        // silently inserting the wrong username.
+        return 'C:\\Users\\%USERNAME%\\' + subpath.replace(/\//g, '\\');
+    }
+    return '';
+}
+//# sourceMappingURL=suggestPath.js.map

package/dist/utils/suggestPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestPath.js","sourceRoot":"","sources":["../../src/utils/suggestPath.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,UAAU,kBAAkB,CAAC,SAAiB,EAAE,QAAe;IACnE,IAAI,OAAO,SAAS,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAC7C,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACxD,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAExB,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,yEAAyE;QACzE,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACvE,IAAI,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC;QAClB,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACzC,OAAO,IAAI,GAAG,OAAO,CAAC;IACxB,CAAC;IAED,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QAClD,IAAI,OAAO,GAAkB,IAAI,CAAC;QAClC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;YACpD,IAAI,GAAG,EAAE,CAAC;gBACR,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;YACnB,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;gBACnD,IAAI,GAAG;oBAAE,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QACD,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QACxB,oEAAoE;QACpE,mEAAmE;QACnE,yCAAyC;QACzC,OAAO,yBAAyB,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@noesis-brain/mcp-server",
+  "version": "2.0.0",
+  "description": "Official MCP server for Noesis — bring your personal knowledge base into Claude Code. Search, sync, and manage your notes via 19 AI-powered tools.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "noesis-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "scripts",
+    "skill-templates",
+    "templates",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx watch src/index.ts"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "claude-code",
+    "noesis",
+    "markdown",
+    "notes",
+    "knowledge-base",
+    "personal-knowledge-management",
+    "pkm",
+    "second-brain",
+    "ai",
+    "semantic-search"
+  ],
+  "author": "Noesis",
+  "license": "MIT",
+  "homepage": "https://noesisbrain.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/noesis-brain/mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/noesis-brain/mcp-server/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@google/genai": "^1.0.0",
+    "@google/generative-ai": "^0.21.0",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "dotenv": "^16.3.0",
+    "js-yaml": "^4.1.1",
+    "node-diff3": "^3.2.0",
+    "pg": "^8.11.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.0.0",
+    "@types/pg": "^8.10.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  }
+}