obsidian-mcp-server 2.0.6 → 3.0.0

package/dist/services/obsidian/section-extractor.js

@@ -0,0 +1,124 @@
+/**
+ * @fileoverview Client-side section extraction from a NoteJson body.
+ * The upstream Local REST API exposes section *targeting* for PATCH but not
+ * section-extracted GET, so we slice the markdown ourselves for `format: 'section'`.
+ * @module services/obsidian/section-extractor
+ */
+import { notFound } from '@cyanheads/mcp-ts-core/errors';
+/**
+ * Extract a section's raw markdown (heading/block) or JSON value (frontmatter).
+ * Throws `NotFound` if the target does not exist in the note.
+ */
+export function extractSection(note, section) {
+    switch (section.type) {
+        case 'frontmatter':
+            return extractFrontmatterField(note, section.target);
+        case 'heading':
+            return extractHeading(note.content, section.target);
+        case 'block':
+            return extractBlock(note.content, section.target);
+    }
+}
+function extractFrontmatterField(note, key) {
+    if (!(key in note.frontmatter)) {
+        throw notFound(`Frontmatter key '${key}' not found in ${note.path}.`, {
+            path: note.path,
+            key,
+        });
+    }
+    return note.frontmatter[key];
+}
+/**
+ * Match a heading by "::"-delimited hierarchy. "Top::Sub" walks to a level-N
+ * heading "Top" and then a deeper heading "Sub" beneath it.
+ */
+function extractHeading(content, target) {
+    const parts = target
+        .split('::')
+        .map((p) => p.trim())
+        .filter(Boolean);
+    if (parts.length === 0) {
+        throw notFound('Empty heading target.', { target });
+    }
+    const lines = content.split('\n');
+    const bodyStart = frontmatterEndLine(lines);
+    let cursor = bodyStart;
+    let parentLevel = 0;
+    for (const part of parts) {
+        let found = -1;
+        let foundLevel = 0;
+        for (let i = cursor; i < lines.length; i++) {
+            const m = /^(#{1,6})\s+(.*?)\s*$/.exec(lines[i] ?? '');
+            if (!m)
+                continue;
+            const level = (m[1] ?? '').length;
+            const text = (m[2] ?? '').trim();
+            if (parentLevel > 0 && level <= parentLevel) {
+                // exited the parent; stop searching deeper for this part
+                break;
+            }
+            if (text === part && (parentLevel === 0 || level > parentLevel)) {
+                found = i;
+                foundLevel = level;
+                break;
+            }
+        }
+        if (found === -1) {
+            throw notFound(`Heading '${target}' not found.`, { target });
+        }
+        cursor = found + 1;
+        parentLevel = foundLevel;
+    }
+    // Slice from the matched heading line to the next heading at the same or shallower level.
+    const startLine = cursor - 1;
+    let endLine = lines.length;
+    for (let i = cursor; i < lines.length; i++) {
+        const m = /^(#{1,6})\s+/.exec(lines[i] ?? '');
+        if (m && (m[1] ?? '').length <= parentLevel) {
+            endLine = i;
+            break;
+        }
+    }
+    return lines.slice(startLine, endLine).join('\n').replace(/\n+$/, '');
+}
+/**
+ * Match a block by its `^blockId` reference. Returns the line containing the
+ * reference plus any preceding lines belonging to the same paragraph (until a
+ * blank line or heading).
+ */
+function extractBlock(content, blockId) {
+    const lines = content.split('\n');
+    const bodyStart = frontmatterEndLine(lines);
+    const escaped = blockId.replace(/[\\^$.*+?()[\]{}|]/g, '\\$&');
+    const ref = new RegExp(`(^|\\s)\\^${escaped}\\s*$`);
+    for (let i = bodyStart; i < lines.length; i++) {
+        if (ref.test(lines[i] ?? '')) {
+            let start = i;
+            while (start > bodyStart) {
+                const prev = lines[start - 1] ?? '';
+                if (prev.trim() === '' || /^#{1,6}\s+/.test(prev))
+                    break;
+                start--;
+            }
+            return lines.slice(start, i + 1).join('\n');
+        }
+    }
+    throw notFound(`Block reference '^${blockId}' not found.`, { blockId });
+}
+/**
+ * Return the line index where the document body starts, skipping a leading
+ * `---`/`---` YAML frontmatter block. Returns 0 when no frontmatter is present.
+ * Without this guard, heading and block extraction would scan inside the
+ * frontmatter and falsely match YAML comment lines or include the fence in a
+ * paragraph walk-back.
+ */
+function frontmatterEndLine(lines) {
+    if (!/^---\s*$/.test(lines[0] ?? ''))
+        return 0;
+    for (let i = 1; i < lines.length; i++) {
+        if (/^---\s*$/.test(lines[i] ?? ''))
+            return i + 1;
+    }
+    return 0;
+}
+//# sourceMappingURL=section-extractor.js.map

package/dist/services/obsidian/section-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-extractor.js","sourceRoot":"","sources":["../../../src/services/obsidian/section-extractor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAGzD;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAc,EAAE,OAAsB;IACnE,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,aAAa;YAChB,OAAO,uBAAuB,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACvD,KAAK,SAAS;YACZ,OAAO,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACtD,KAAK,OAAO;YACV,OAAO,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,CAAC,IAAc,EAAE,GAAW;IAC1D,IAAI,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/B,MAAM,QAAQ,CAAC,oBAAoB,GAAG,kBAAkB,IAAI,CAAC,IAAI,GAAG,EAAE;YACpE,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,OAAe,EAAE,MAAc;IACrD,MAAM,KAAK,GAAG,MAAM;SACjB,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,QAAQ,CAAC,uBAAuB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,MAAM,GAAG,SAAS,CAAC;IACvB,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;QACf,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,KAAK,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,MAAM,CAAC,GAAG,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACvD,IAAI,CAAC,CAAC;gBAAE,SAAS;YACjB,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YAClC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACjC,IAAI,WAAW,GAAG,CAAC,IAAI,KAAK,IAAI,WAAW,EAAE,CAAC;gBAC5C,yDAAyD;gBACzD,MAAM;YACR,CAAC;YACD,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,WAAW,KAAK,CAAC,IAAI,KAAK,GAAG,WAAW,CAAC,EAAE,CAAC;gBAChE,KAAK,GAAG,CAAC,CAAC;gBACV,UAAU,GAAG,KAAK,CAAC;gBACnB,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACjB,MAAM,QAAQ,CAAC,YAAY,MAAM,cAAc,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,MAAM,GAAG,KAAK,GAAG,CAAC,CAAC;QACnB,WAAW,GAAG,UAAU,CAAC;IAC3B,CAAC;IAED,0FAA0F;IAC1F,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,CAAC;IAC7B,IAAI,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,WAAW,EAAE,CAAC;YAC5C,OAAO,GAAG,CAAC,CAAC;YACZ,MAAM;QACR,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACxE,CAAC;AAED;;;;GAIG;AACH,SAAS,YAAY,CAAC,OAAe,EAAE,OAAe;IACpD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IAC/D,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,aAAa,OAAO,OAAO,CAAC,CAAC;IACpD,KAAK,IAAI,CAAC,GAAG,SAAS,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAC7B,IAAI,KAAK,GAAG,CAAC,CAAC;YACd,OAAO,KAAK,GAAG,SAAS,EAAE,CAAC;gBACzB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;gBACpC,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;oBAAE,MAAM;gBACzD,KAAK,EAAE,CAAC;YACV,CAAC;YACD,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IACD,MAAM,QAAQ,CAAC,qBAAqB,OAAO,cAAc,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED;;;;;;GAMG;AACH,SAAS,kBAAkB,CAAC,KAAe;IACzC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAAE,OAAO,CAAC,CAAC;IAC/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/services/obsidian/types.d.ts

@@ -0,0 +1,91 @@
+/**
+ * @fileoverview Shared types for the Obsidian Local REST API service layer.
+ * Mirrors the upstream plugin's response shapes (NoteJson, document map, etc.).
+ * @module services/obsidian/types
+ */
+export type PeriodicPeriod = 'daily' | 'weekly' | 'monthly' | 'quarterly' | 'yearly';
+export type NoteTarget = {
+    type: 'path';
+    path: string;
+} | {
+    type: 'active';
+} | {
+    type: 'periodic';
+    period: PeriodicPeriod;
+    date?: string | undefined;
+};
+export type SectionType = 'heading' | 'block' | 'frontmatter';
+export interface SectionTarget {
+    /** Heading name ("::" delimits nesting), block reference, or frontmatter field name. */
+    target: string;
+    type: SectionType;
+}
+export interface NoteStat {
+    ctime: number;
+    mtime: number;
+    size: number;
+}
+export interface NoteJson {
+    content: string;
+    frontmatter: Record<string, unknown>;
+    path: string;
+    stat: NoteStat;
+    tags: string[];
+}
+export interface DocumentMap {
+    blocks: string[];
+    frontmatterFields: string[];
+    headings: string[];
+}
+export interface FileListing {
+    files: string[];
+}
+export interface VaultStatus {
+    authenticated: boolean;
+    manifest?: {
+        id: string;
+        name: string;
+        version: string;
+    };
+    service: string;
+    status: string;
+    versions?: {
+        obsidian?: string;
+        self?: string;
+    };
+}
+export interface ObsidianTag {
+    count: number;
+    name: string;
+}
+export interface ObsidianCommand {
+    id: string;
+    name: string;
+}
+export type SearchMode = 'text' | 'dataview' | 'jsonlogic';
+export interface TextSearchHit {
+    filename: string;
+    matches: Array<{
+        context: string;
+        match: {
+            start: number;
+            end: number;
+        };
+    }>;
+    score?: number;
+}
+export interface StructuredSearchHit {
+    filename: string;
+    result: unknown;
+}
+export interface PatchHeaders {
+    applyIfContentPreexists?: boolean | undefined;
+    contentType?: 'markdown' | 'json' | undefined;
+    createTargetIfMissing?: boolean | undefined;
+    operation: 'append' | 'prepend' | 'replace';
+    target: string;
+    targetDelimiter?: string | undefined;
+    targetType: SectionType;
+    trimTargetWhitespace?: boolean | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/obsidian/types.d.ts.map

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

package/dist/services/obsidian/types.js

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Shared types for the Obsidian Local REST API service layer.
+ * Mirrors the upstream plugin's response shapes (NoteJson, document map, etc.).
+ * @module services/obsidian/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/obsidian/types.js.map

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

package/package.json

@@ -1,91 +1,85 @@
 {
   "name": "obsidian-mcp-server",
-  "version": "2.0.6",
-  "description": "Obsidian Knowledge-Management MCP (Model Context Protocol) server that enables AI agents and development tools to interact with an Obsidian vault. It provides a comprehensive suite of tools for reading, writing, searching, and managing notes, tags, and frontmatter, acting as a bridge to the Obsidian Local REST API plugin.",
+  "version": "3.0.0",
+  "mcpName": "io.github.cyanheads/obsidian-mcp-server",
+  "description": "MCP server for Obsidian vaults — read, write, search, and surgically edit notes, tags, and frontmatter via the Local REST API plugin. STDIO or Streamable HTTP.",
+  "type": "module",
   "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "obsidian-mcp-server": "dist/index.js"
+  },
   "files": [
-    "dist",
+    "changelog/",
+    "dist/",
     "README.md",
     "LICENSE",
-    "CHANGELOG.md"
+    "CLAUDE.md",
+    "Dockerfile",
+    "server.json"
   ],
-  "bin": {
-    "obsidian-mcp-server": "dist/index.js"
-  },
-  "type": "module",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/cyanheads/obsidian-mcp-server.git"
-  },
-  "bugs": {
-    "url": "https://github.com/cyanheads/obsidian-mcp-server/issues"
-  },
-  "homepage": "https://github.com/cyanheads/obsidian-mcp-server#readme",
   "scripts": {
-    "build": "tsc && node --loader ts-node/esm scripts/make-executable.ts dist/index.js",
+    "build": "bun run scripts/build.ts",
+    "rebuild": "bun run scripts/clean.ts && bun run build",
+    "clean": "bun run scripts/clean.ts",
+    "devcheck": "bun run scripts/devcheck.ts",
+    "tree": "bun run scripts/tree.ts",
+    "format": "biome check --write --unsafe .",
+    "lint:mcp": "bun run scripts/lint-mcp.ts",
+    "changelog:build": "bun run scripts/build-changelog.ts",
+    "changelog:check": "bun run scripts/build-changelog.ts --check",
+    "test": "bunx vitest run",
+    "dev:stdio": "MCP_TRANSPORT_TYPE=stdio bun --watch src/index.ts",
+    "dev:http": "MCP_TRANSPORT_TYPE=http bun --watch src/index.ts",
     "start": "node dist/index.js",
-    "start:stdio": "MCP_LOG_LEVEL=debug MCP_TRANSPORT_TYPE=stdio node dist/index.js",
-    "start:http": "MCP_LOG_LEVEL=debug MCP_TRANSPORT_TYPE=http node dist/index.js",
-    "rebuild": "npx ts-node --esm scripts/clean.ts && npm run build",
-    "fetch:spec": "npx ts-node --esm scripts/fetch-openapi-spec.ts",
-    "docs:generate": "typedoc --tsconfig ./tsconfig.typedoc.json",
-    "tree": "npx ts-node --esm scripts/tree.ts",
-    "format": "prettier --write \"**/*.{ts,js,json,md,html,css}\"",
-    "inspect": "mcp-inspector --config mcp.json",
-    "inspect:stdio": "mcp-inspector --config mcp.json --server obsidian-mcp-server-stdio",
-    "inspect:http": "mcp-inspector --config mcp.json --server obsidian-mcp-server-http"
-  },
-  "dependencies": {
-    "@hono/node-server": "^1.14.4",
-    "@modelcontextprotocol/inspector": "^0.14.3",
-    "@modelcontextprotocol/sdk": "^1.13.0",
-    "@types/sanitize-html": "^2.16.0",
-    "@types/validator": "13.15.2",
-    "axios": "^1.10.0",
-    "chrono-node": "2.8.0",
-    "date-fns": "^4.1.0",
-    "dotenv": "^16.5.0",
-    "hono": "^4.8.2",
-    "ignore": "^7.0.5",
-    "jose": "^6.0.11",
-    "js-yaml": "^4.1.0",
-    "openai": "^5.6.0",
-    "partial-json": "^0.1.7",
-    "sanitize-html": "^2.17.0",
-    "tiktoken": "^1.0.21",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.8.3",
-    "validator": "13.15.15",
-    "winston": "^3.17.0",
-    "winston-transport": "^4.9.0",
-    "zod": "^3.25.67"
+    "start:stdio": "MCP_TRANSPORT_TYPE=stdio bun ./dist/index.js",
+    "start:http": "MCP_TRANSPORT_TYPE=http bun ./dist/index.js"
   },
   "keywords": [
     "mcp",
+    "mcp-server",
     "model-context-protocol",
     "obsidian",
-    "obsidian-md",
-    "ai",
-    "llm",
-    "agent",
-    "automation",
-    "api",
-    "server",
-    "typescript",
-    "knowledge-management",
+    "obsidian-vault",
+    "knowledge-base",
     "note-taking",
-    "rest-api",
-    "integration"
+    "llm",
+    "llm-agent",
+    "ai-tools",
+    "typescript"
   ],
-  "author": "Casey Hand @cyanheads",
+  "author": "cyanheads <casey@caseyjhand.com> (https://github.com/cyanheads/obsidian-mcp-server#readme)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cyanheads/obsidian-mcp-server.git"
+  },
+  "homepage": "https://github.com/cyanheads/obsidian-mcp-server#readme",
+  "bugs": {
+    "url": "https://github.com/cyanheads/obsidian-mcp-server/issues"
+  },
   "license": "Apache-2.0",
   "engines": {
-    "node": ">=16.0.0"
+    "bun": ">=1.3.11",
+    "node": ">=22.0.0"
   },
-  "devDependencies": {
+  "packageManager": "bun@1.3.11",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@cyanheads/mcp-ts-core": "^0.8.1",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "^24.0.3",
-    "prettier": "^3.5.3",
-    "typedoc": "^0.28.5"
+    "js-yaml": "^4.1.1",
+    "pino-pretty": "^13.1.3",
+    "undici": "^8.1.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.13",
+    "@types/node": "^25.6.0",
+    "depcheck": "^1.4.7",
+    "ignore": "^7.0.5",
+    "tsc-alias": "^1.8.16",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
   }
 }

package/server.json

@@ -0,0 +1,167 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.cyanheads/obsidian-mcp-server",
+  "description": "MCP server for Obsidian vaults — read, write, search, and edit notes via the Local REST API plugin.",
+  "repository": {
+    "url": "https://github.com/cyanheads/obsidian-mcp-server",
+    "source": "github"
+  },
+  "version": "3.0.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "identifier": "obsidian-mcp-server",
+      "runtimeHint": "node",
+      "version": "3.0.0",
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "run"
+        },
+        {
+          "type": "positional",
+          "value": "start:stdio"
+        }
+      ],
+      "environmentVariables": [
+        {
+          "name": "OBSIDIAN_API_KEY",
+          "description": "Bearer token for the Obsidian Local REST API plugin (Settings → Community Plugins → Local REST API).",
+          "format": "string",
+          "isRequired": true
+        },
+        {
+          "name": "OBSIDIAN_BASE_URL",
+          "description": "Base URL of the Obsidian Local REST API. Default: http://127.0.0.1:27123 (enable \"Non-encrypted (HTTP) Server\" in plugin settings). Use https://127.0.0.1:27124 for the always-on HTTPS port (self-signed cert; pair with OBSIDIAN_VERIFY_SSL=false).",
+          "format": "string",
+          "isRequired": false,
+          "default": "http://127.0.0.1:27123"
+        },
+        {
+          "name": "OBSIDIAN_VERIFY_SSL",
+          "description": "Whether to verify the TLS certificate on the Obsidian endpoint. Default false because the plugin uses a self-signed cert.",
+          "format": "string",
+          "isRequired": false,
+          "default": "false"
+        },
+        {
+          "name": "OBSIDIAN_REQUEST_TIMEOUT_MS",
+          "description": "Per-request timeout in milliseconds.",
+          "format": "string",
+          "isRequired": false,
+          "default": "30000"
+        },
+        {
+          "name": "OBSIDIAN_ENABLE_COMMANDS",
+          "description": "Opt-in flag for obsidian_execute_command. Off by default — Obsidian commands are opaque and can be destructive.",
+          "format": "string",
+          "isRequired": false,
+          "default": "false"
+        },
+        {
+          "name": "MCP_LOG_LEVEL",
+          "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
+          "format": "string",
+          "isRequired": false,
+          "default": "info"
+        }
+      ],
+      "transport": {
+        "type": "stdio"
+      }
+    },
+    {
+      "registryType": "npm",
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "identifier": "obsidian-mcp-server",
+      "runtimeHint": "node",
+      "version": "3.0.0",
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "run"
+        },
+        {
+          "type": "positional",
+          "value": "start:http"
+        }
+      ],
+      "environmentVariables": [
+        {
+          "name": "OBSIDIAN_API_KEY",
+          "description": "Bearer token for the Obsidian Local REST API plugin (Settings → Community Plugins → Local REST API).",
+          "format": "string",
+          "isRequired": true
+        },
+        {
+          "name": "OBSIDIAN_BASE_URL",
+          "description": "Base URL of the Obsidian Local REST API. Default: http://127.0.0.1:27123 (enable \"Non-encrypted (HTTP) Server\" in plugin settings). Use https://127.0.0.1:27124 for the always-on HTTPS port (self-signed cert; pair with OBSIDIAN_VERIFY_SSL=false).",
+          "format": "string",
+          "isRequired": false,
+          "default": "http://127.0.0.1:27123"
+        },
+        {
+          "name": "OBSIDIAN_VERIFY_SSL",
+          "description": "Whether to verify the TLS certificate on the Obsidian endpoint. Default false because the plugin uses a self-signed cert.",
+          "format": "string",
+          "isRequired": false,
+          "default": "false"
+        },
+        {
+          "name": "OBSIDIAN_REQUEST_TIMEOUT_MS",
+          "description": "Per-request timeout in milliseconds.",
+          "format": "string",
+          "isRequired": false,
+          "default": "30000"
+        },
+        {
+          "name": "OBSIDIAN_ENABLE_COMMANDS",
+          "description": "Opt-in flag for obsidian_execute_command. Off by default — Obsidian commands are opaque and can be destructive.",
+          "format": "string",
+          "isRequired": false,
+          "default": "false"
+        },
+        {
+          "name": "MCP_HTTP_HOST",
+          "description": "The hostname for the HTTP server.",
+          "format": "string",
+          "isRequired": false,
+          "default": "127.0.0.1"
+        },
+        {
+          "name": "MCP_HTTP_PORT",
+          "description": "The port to run the HTTP server on.",
+          "format": "string",
+          "isRequired": false,
+          "default": "3010"
+        },
+        {
+          "name": "MCP_HTTP_ENDPOINT_PATH",
+          "description": "The endpoint path for the MCP server.",
+          "format": "string",
+          "isRequired": false,
+          "default": "/mcp"
+        },
+        {
+          "name": "MCP_AUTH_MODE",
+          "description": "Authentication mode to use: 'none', 'jwt', or 'oauth'.",
+          "format": "string",
+          "isRequired": false,
+          "default": "none"
+        },
+        {
+          "name": "MCP_LOG_LEVEL",
+          "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
+          "format": "string",
+          "isRequired": false,
+          "default": "info"
+        }
+      ],
+      "transport": {
+        "type": "streamable-http",
+        "url": "http://localhost:3010/mcp"
+      }
+    }
+  ]
+}