obsidian-mcp-server 2.0.4 → 2.0.5

package/CHANGELOG.md

@@ -5,6 +5,15 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.0.5] - 2025-06-20
+
+### Changed
+
+- **Tool Renaming**: Renamed the `obsidian_update_file` tool to `obsidian_update_note` to avoid conflicts and better reflect its function. During agentic use, LLMs confused this tool with filesystem operations, leading to errors. The new name clarifies that it operates on Obsidian notes specifically.
+- **HTTP Transport Refactor**: Restructured the HTTP transport layer for improved clarity and robustness. Authentication logic is now more modular, and a centralized error handler has been implemented.
+- **Dependency Updates**: Updated all dependencies to their latest versions.
+- **Documentation Improvements**: Enhanced the documentation around installation & MCP Client configuration. Suggested by [@bgheneti](https://github.com/bgheneti) in [PR #14](https://github.com/cyanheads/obsidian-mcp-server/pull/14). Thanks!
+
 ## [2.0.4] - 2025-06-13
 
 ### Added

package/README.md

@@ -1,8 +1,8 @@
 # Obsidian MCP Server
 
 [![TypeScript](https://img.shields.io/badge/TypeScript-^5.8.3-blue.svg)](https://www.typescriptlang.org/)
-[![Model Context Protocol](https://img.shields.io/badge/MCP%20SDK-^1.12.1-green.svg)](https://modelcontextprotocol.io/)
-[![Version](https://img.shields.io/badge/Version-2.0.3-blue.svg)](./CHANGELOG.md)
+[![Model Context Protocol](https://img.shields.io/badge/MCP%20SDK-^1.13.0-green.svg)](https://modelcontextprotocol.io/)
+[![Version](https://img.shields.io/badge/Version-2.0.5-blue.svg)](./CHANGELOG.md)
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 [![Status](https://img.shields.io/badge/Status-Production-brightgreen.svg)](https://github.com/cyanheads/obsidian-mcp-server/issues)
 [![GitHub](https://img.shields.io/github/stars/cyanheads/obsidian-mcp-server?style=social)](https://github.com/cyanheads/obsidian-mcp-server)
@@ -20,7 +20,7 @@ This server equips your AI with specialized tools to interact with your Obsidian
 | Tool Name                                                                              | Description                                                     | Key Features                                                                                                                                           |
 | :------------------------------------------------------------------------------------- | :-------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------- |
 | [`obsidian_read_file`](./src/mcp-server/tools/obsidianReadFileTool/)                   | Retrieves the content and metadata of a specified file.         | - Read in `markdown` or `json` format.<br/>- Case-insensitive path fallback.<br/>- Includes file stats (creation/modification time).                   |
-| [`obsidian_update_file`](./src/mcp-server/tools/obsidianUpdateFileTool/)               | Modifies notes using whole-file operations.                     | - `append`, `prepend`, or `overwrite` content.<br/>- Can create files if they don't exist.<br/>- Targets files by path, active note, or periodic note. |
+| [`obsidian_update_note`](./src/mcp-server/tools/obsidianUpdateNoteTool/)               | Modifies notes using whole-file operations.                     | - `append`, `prepend`, or `overwrite` content.<br/>- Can create files if they don't exist.<br/>- Targets files by path, active note, or periodic note. |
 | [`obsidian_search_replace`](./src/mcp-server/tools/obsidianSearchReplaceTool/)         | Performs search-and-replace operations within a target note.    | - Supports string or regex search.<br/>- Options for case sensitivity, whole word, and replacing all occurrences.                                      |
 | [`obsidian_global_search`](./src/mcp-server/tools/obsidianGlobalSearchTool/)           | Performs a search across the entire vault.                      | - Text or regex search.<br/>- Filter by path and modification date.<br/>- Paginated results.                                                           |
 | [`obsidian_list_files`](./src/mcp-server/tools/obsidianListFilesTool/)                 | Lists files and subdirectories within a specified vault folder. | - Filter by file extension or name regex.<br/>- Provides a formatted tree view of the directory.                                                       |
@@ -32,8 +32,8 @@ This server equips your AI with specialized tools to interact with your Obsidian
 
 ## Table of Contents
 
-| [Overview](#overview) | [Features](#features) | [Installation](#installation) |
-| [Configuration](#configuration) | [Project Structure](#project-structure) | [Vault Cache Service](#vault-cache-service) |
+| [Overview](#overview) | [Features](#features) | [Configuration](#configuration) |
+| [Project Structure](#project-structure) | [Vault Cache Service](#vault-cache-service) |
 | [Tools](#tools) | [Resources](#resources) | [Development](#development) | [License](#license) |
 
 ## Overview
@@ -54,7 +54,7 @@ Built on the robust `mcp-ts-template`, this server provides a standardized, secu
 
 ### Core Utilities
 
-Leverages the robust utilities provided by the `mcp-ts-template`:
+Leverages the robust utilities provided by `cyanheads/mcp-ts-template`:
 
 - **Logging**: Structured, configurable logging (file rotation, console, MCP notifications) with sensitive data redaction.
 - **Error Handling**: Centralized error processing, standardized error types (`McpError`), and automatic logging.
@@ -62,7 +62,7 @@ Leverages the robust utilities provided by the `mcp-ts-template`:
 - **Input Validation/Sanitization**: Uses `zod` for schema validation and custom sanitization logic.
 - **Request Context**: Tracking and correlation of operations via unique request IDs.
 - **Type Safety**: Strong typing enforced by TypeScript and Zod schemas.
-- **HTTP Transport Option**: Built-in Hono server with SSE, session management, CORS support, and JWT authentication.
+- **HTTP Transport Option**: Built-in Hono server with SSE, session management, CORS support, and pluggable authentication strategies (JWT and OAuth 2.1).
 
 ### Obsidian Integration
 
@@ -82,52 +82,73 @@ Leverages the robust utilities provided by the `mcp-ts-template`:
 3.  **API Key**: Configure an API key within the Local REST API plugin settings in Obsidian. You will need this key to configure the server.
 4.  **Node.js & npm**: Ensure you have Node.js (v18 or later recommended) and npm installed.
 
-### Install via npm (Recommended)
+## Configuration
 
-```bash
-npm install obsidian-mcp-server
-```
+### MCP Client Settings
 
-### Install from Source
-
-1.  Clone the repository:
-    ```bash
-    git clone https://github.com/cyanheads/obsidian-mcp-server.git
-    cd obsidian-mcp-server
-    ```
-2.  Install dependencies:
-    ```bash
-    npm install
-    ```
-3.  Build the project:
-    ```bash
-    npm run build
-    ```
-    This compiles the TypeScript code to JavaScript in the `dist/` directory and makes the entry point executable.
+Add the following to your MCP client's configuration file (e.g., `cline_mcp_settings.json`). This configuration uses `npx` to run the server, which will automatically download & install the package if not already present:
 
-## Configuration
+```json
+{
+  "mcpServers": {
+    "obsidian-mcp-server": {
+      "command": "npx",
+      "args": ["obsidian-mcp-server"],
+      "env": {
+        "OBSIDIAN_API_KEY": "YOUR_API_KEY_FROM_OBSIDIAN_PLUGIN",
+        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123",
+        "OBSIDIAN_VERIFY_SSL": "false",
+        "OBSIDIAN_ENABLE_CACHE": "true"
+      },
+      "disabled": false,
+      "autoApprove": []
+    }
+  }
+}
+```
 
-### Environment Variables
+**Note**: Verify SSL is set to false here because the Obsidian Local REST API plugin uses a self-signed certificate by default. If you are deploying this in a production environment, consider using the encrypted HTTPS endpoint and set `OBSIDIAN_VERIFY_SSL` to `true` after configuring your server to trust the self-signed certificate.
 
-Configure the server using environment variables.
+If you installed from source, change `command` and `args` to point to your local build:
 
-These variables must be set in the MCP client configuration (e.g., `cline_mcp_settings.json`) or in your environment before starting the server (if running directly).
+```json
+{
+  "mcpServers": {
+    "obsidian-mcp-server": {
+      "command": "node",
+      "args": ["/path/to/your/obsidian-mcp-server/dist/index.js"],
+      "env": {
+        "OBSIDIAN_API_KEY": "YOUR_OBSIDIAN_API_KEY",
+        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123",
+        "OBSIDIAN_VERIFY_SSL": "false",
+        "OBSIDIAN_ENABLE_CACHE": "true"
+      }
+    }
+  }
+}
+```
 
-If running directly, they can be set in a `.env` file in the project root or directly in your environment.
+### Environment Variables
 
-| Variable                              | Description                                               | Required          | Default                  |
-| :------------------------------------ | :-------------------------------------------------------- | :---------------- | :----------------------- |
-| **`OBSIDIAN_API_KEY`**                | API Key from the Obsidian Local REST API plugin.          | **Yes**           | `undefined`              |
-| **`OBSIDIAN_BASE_URL`**               | Base URL of your Obsidian Local REST API.                 | **Yes**           | `http://127.0.0.1:27123` |
-| `MCP_TRANSPORT_TYPE`                  | Server transport: `stdio` or `http`.                      | No                | `stdio`                  |
-| `MCP_HTTP_PORT`                       | Port for the HTTP server.                                 | No                | `3010`                   |
-| `MCP_HTTP_HOST`                       | Host for the HTTP server.                                 | No                | `127.0.0.1`              |
-| `MCP_ALLOWED_ORIGINS`                 | Comma-separated origins for CORS. **Set for production.** | No                | (none)                   |
-| **`MCP_AUTH_SECRET_KEY`**             | 32+ char secret for JWT auth. **Required for HTTP.**      | **Yes (if HTTP)** | `undefined`              |
-| `MCP_LOG_LEVEL`                       | Logging level (`debug`, `info`, `error`, etc.).           | No                | `info`                   |
-| `OBSIDIAN_VERIFY_SSL`                 | Set to `false` to disable SSL verification.               | No                | `true`                   |
-| `OBSIDIAN_ENABLE_CACHE`               | Set to `true` to enable the in-memory vault cache.        | No                | `true`                   |
-| `OBSIDIAN_CACHE_REFRESH_INTERVAL_MIN` | Refresh interval for the vault cache in minutes.          | No                | `10`                     |
+Configure the server using environment variables. These environmental variables are set within your MCP client config/settings (e.g. `cline_mcp_settings.json` for Cline, `claude_desktop_config.json` for Claude Desktop).
+
+| Variable                              | Description                                                              | Required             | Default                  |
+| :------------------------------------ | :----------------------------------------------------------------------- | :------------------- | :----------------------- |
+| **`OBSIDIAN_API_KEY`**                | API Key from the Obsidian Local REST API plugin.                         | **Yes**              | `undefined`              |
+| **`OBSIDIAN_BASE_URL`**               | Base URL of your Obsidian Local REST API.                                | **Yes**              | `http://127.0.0.1:27123` |
+| `MCP_TRANSPORT_TYPE`                  | Server transport: `stdio` or `http`.                                     | No                   | `stdio`                  |
+| `MCP_HTTP_PORT`                       | Port for the HTTP server.                                                | No                   | `3010`                   |
+| `MCP_HTTP_HOST`                       | Host for the HTTP server.                                                | No                   | `127.0.0.1`              |
+| `MCP_ALLOWED_ORIGINS`                 | Comma-separated origins for CORS. **Set for production.**                | No                   | (none)                   |
+| `MCP_AUTH_MODE`                       | Authentication strategy: `jwt` or `oauth`.                               | No                   | (none)                   |
+| **`MCP_AUTH_SECRET_KEY`**             | 32+ char secret for JWT. **Required for `jwt` mode.**                    | **Yes (if `jwt`)**   | `undefined`              |
+| `OAUTH_ISSUER_URL`                    | URL of the OAuth 2.1 issuer.                                             | **Yes (if `oauth`)** | `undefined`              |
+| `OAUTH_AUDIENCE`                      | Audience claim for OAuth tokens.                                         | **Yes (if `oauth`)** | `undefined`              |
+| `OAUTH_JWKS_URI`                      | URI for the JSON Web Key Set (optional, derived from issuer if omitted). | No                   | (derived)                |
+| `MCP_LOG_LEVEL`                       | Logging level (`debug`, `info`, `error`, etc.).                          | No                   | `info`                   |
+| `OBSIDIAN_VERIFY_SSL`                 | Set to `false` to disable SSL verification.                              | No                   | `true`                   |
+| `OBSIDIAN_ENABLE_CACHE`               | Set to `true` to enable the in-memory vault cache.                       | No                   | `true`                   |
+| `OBSIDIAN_CACHE_REFRESH_INTERVAL_MIN` | Refresh interval for the vault cache in minutes.                         | No                   | `10`                     |
 
 ### Connecting to the Obsidian API
 
@@ -165,27 +186,6 @@ _Using the encrypted HTTPS URL:_
 }
 ```
 
-### MCP Client Settings
-
-Add to your MCP client settings (e.g., `cline_mcp_settings.json`):
-
-```json
-{
-  "mcpServers": {
-    "obsidian-mcp-server": {
-      "command": "node",
-      "args": ["/path/to/your/obsidian-mcp-server/dist/index.js"],
-      "env": {
-        "OBSIDIAN_API_KEY": "YOUR_OBSIDIAN_API_KEY",
-        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123",
-        "OBSIDIAN_VERIFY_SSL": "false",
-        "OBSIDIAN_ENABLE_CACHE": "true"
-      }
-    }
-  }
-}
-```
-
 ## Project Structure
 
 The codebase follows a modular structure within the `src/` directory:
@@ -199,7 +199,8 @@ src/
 │   ├── server.ts      # Server setup, transport handling, tool/resource registration
 │   ├── resources/     # MCP Resource implementations (currently none)
 │   ├── tools/         # MCP Tool implementations (subdirs per tool)
-│   └── transports/    # Stdio and HTTP transport logic, auth middleware
+│   └── transports/    # Stdio and HTTP transport logic
+│       └── auth/      # Authentication strategies (JWT, OAuth)
 ├── services/          # Abstractions for external APIs or internal caching
 │   └── obsidianRestAPI/ # Typed client for Obsidian Local REST API
 ├── types-global/      # Shared TypeScript type definitions (errors, etc.)
@@ -239,7 +240,7 @@ The Obsidian MCP Server provides a suite of tools for interacting with your vaul
 | Tool Name                     | Description                                               | Key Arguments                                                 |
 | :---------------------------- | :-------------------------------------------------------- | :------------------------------------------------------------ |
 | `obsidian_read_file`          | Retrieves the content and metadata of a file.             | `filePath`, `format?`, `includeStat?`                         |
-| `obsidian_update_file`        | Modifies a file by appending, prepending, or overwriting. | `targetType`, `content`, `targetIdentifier?`, `wholeFileMode` |
+| `obsidian_update_note`        | Modifies a file by appending, prepending, or overwriting. | `targetType`, `content`, `targetIdentifier?`, `wholeFileMode` |
 | `obsidian_search_replace`     | Performs search-and-replace operations in a note.         | `targetType`, `replacements`, `useRegex?`, `replaceAll?`      |
 | `obsidian_global_search`      | Searches the entire vault for content.                    | `query`, `searchInPath?`, `useRegex?`, `page?`, `pageSize?`   |
 | `obsidian_list_files`         | Lists files and subdirectories in a folder.               | `dirPath`, `fileExtensionFilter?`, `nameRegexFilter?`         |
@@ -259,32 +260,23 @@ This server currently focuses on providing interactive tools for vault manipulat
 
 ### Build and Test
 
+To get started with development, clone the repository, install dependencies, and use the following scripts:
+
 ```bash
-# Build the project (compile TS to JS in dist/ and make executable)
-npm run build
+# Install dependencies
+npm install
 
-# Format code using Prettier
-npm run format
+# Build the project (compile TS to JS in dist/ and make executable)
+npm run rebuild
 
-# Test the server locally using stdio transport
-npm start
-# or specifically:
-npm run start:stdio
+# Start the server locally using stdio transport
+npm start:stdio
 
-# Test the server locally using http transport
+# Start the server using http transport
 npm run start:http
 
-# Generate a file tree representation for documentation (runs scripts/tree.ts)
-npm run tree
-
-# Clean build artifacts and then rebuild the project
-npm run rebuild
-
-# Fetch the Obsidian API spec (requires Obsidian running with Local REST API)
-npm run fetch:spec http://127.0.0.1:27123/ docs/obsidian-api/obsidian_rest_api_spec
-
-# Generate API documentation using TypeDoc
-npm run docs:generate
+# Format code using Prettier
+npm run format
 
 # Inspect the server's capabilities using the MCP Inspector tool
 npm run inspect:stdio

package/dist/mcp-server/server.js

@@ -24,7 +24,7 @@ import { registerObsidianGlobalSearchTool } from "./tools/obsidianGlobalSearchTo
 import { registerObsidianListFilesTool } from "./tools/obsidianListFilesTool/index.js";
 import { registerObsidianReadFileTool } from "./tools/obsidianReadFileTool/index.js";
 import { registerObsidianSearchReplaceTool } from "./tools/obsidianSearchReplaceTool/index.js";
-import { registerObsidianUpdateFileTool } from "./tools/obsidianUpdateFileTool/index.js";
+import { registerObsidianUpdateNoteTool } from "./tools/obsidianUpdateNoteTool/index.js";
 import { registerObsidianManageFrontmatterTool } from "./tools/obsidianManageFrontmatterTool/index.js";
 import { registerObsidianManageTagsTool } from "./tools/obsidianManageTagsTool/index.js";
 // Import transport setup functions.
@@ -93,7 +93,7 @@ async function createMcpServerInstance(obsidianService, vaultCacheService) {
             logger.warning("Skipping registration of 'obsidian_global_search' because the Vault Cache Service is disabled.", context);
         }
         await registerObsidianSearchReplaceTool(server, obsidianService, vaultCacheService);
-        await registerObsidianUpdateFileTool(server, obsidianService, vaultCacheService);
+        await registerObsidianUpdateNoteTool(server, obsidianService, vaultCacheService);
         await registerObsidianManageFrontmatterTool(server, obsidianService, vaultCacheService);
         await registerObsidianManageTagsTool(server, obsidianService, vaultCacheService);
         logger.info("Resources and tools registered successfully", context);

package/dist/mcp-server/tools/obsidianListFilesTool/logic.js

@@ -118,9 +118,7 @@ async function buildFileTree(dirPath, currentDepth, params, context, obsidianSer
         if (regex && !regex.test(cleanName)) {
             continue;
         }
-        if (!isDirectory &&
-            fileExtensionFilter &&
-            fileExtensionFilter.length > 0) {
+        if (!isDirectory && fileExtensionFilter && fileExtensionFilter.length > 0) {
             const extension = path.posix.extname(name);
             if (!fileExtensionFilter.includes(extension)) {
                 continue;
@@ -166,7 +164,10 @@ export const processObsidianListFiles = async (params, context, obsidianService)
     try {
         const effectiveDirPath = dirPath === "" ? "/" : dirPath;
         // --- Step 1: Build the file tree recursively with retry for the initial call ---
-        const buildTreeContext = { ...context, operation: "buildFileTreeWithRetry" };
+        const buildTreeContext = {
+            ...context,
+            operation: "buildFileTreeWithRetry",
+        };
         const shouldRetryNotFound = (err) => err instanceof McpError && err.code === BaseErrorCode.NOT_FOUND;
         const fileTree = await retryWithDelay(() => buildFileTree(effectiveDirPath, 0, // Start at depth 0
         params, buildTreeContext, obsidianService), {

package/dist/mcp-server/tools/{obsidianUpdateFileTool → obsidianUpdateNoteTool}/index.d.ts

@@ -1,12 +1,12 @@
 /**
- * @fileoverview Barrel file for the 'obsidian_update_file' MCP tool.
+ * @fileoverview Barrel file for the 'obsidian_update_note' MCP tool.
  *
- * This file serves as the public entry point for the obsidian_update_file tool module.
- * It re-exports the primary registration function (`registerObsidianUpdateFileTool`)
+ * This file serves as the public entry point for the obsidian_update_note tool module.
+ * It re-exports the primary registration function (`registerObsidianUpdateNoteTool`)
  * from the './registration.js' module. This pattern simplifies imports for consumers
  * of the tool, allowing them to import necessary components from a single location.
  *
  * Consumers (like the main server setup) should import the registration function
  * from this file to integrate the tool into the MCP server instance.
  */
-export { registerObsidianUpdateFileTool } from "./registration.js";
+export { registerObsidianUpdateNoteTool } from "./registration.js";

package/dist/mcp-server/tools/{obsidianUpdateFileTool → obsidianUpdateNoteTool}/index.js

@@ -1,12 +1,12 @@
 /**
- * @fileoverview Barrel file for the 'obsidian_update_file' MCP tool.
+ * @fileoverview Barrel file for the 'obsidian_update_note' MCP tool.
  *
- * This file serves as the public entry point for the obsidian_update_file tool module.
- * It re-exports the primary registration function (`registerObsidianUpdateFileTool`)
+ * This file serves as the public entry point for the obsidian_update_note tool module.
+ * It re-exports the primary registration function (`registerObsidianUpdateNoteTool`)
  * from the './registration.js' module. This pattern simplifies imports for consumers
  * of the tool, allowing them to import necessary components from a single location.
  *
  * Consumers (like the main server setup) should import the registration function
  * from this file to integrate the tool into the MCP server instance.
  */
-export { registerObsidianUpdateFileTool } from "./registration.js";
+export { registerObsidianUpdateNoteTool } from "./registration.js";

package/dist/mcp-server/tools/{obsidianUpdateFileTool → obsidianUpdateNoteTool}/logic.d.ts

@@ -8,7 +8,7 @@ import { RequestContext } from "../../../utils/index.js";
  * relying on the refined schema (`ObsidianUpdateFileInputSchema`) for stricter validation
  * within the handler logic.
  */
-declare const ObsidianUpdateFileRegistrationSchema: z.ZodObject<{
+declare const ObsidianUpdateNoteRegistrationSchema: z.ZodObject<{
     /** Specifies the target note: 'filePath' (requires targetIdentifier), 'activeFile' (currently open file), or 'periodicNote' (requires targetIdentifier with period like 'daily'). */
     targetType: z.ZodEnum<["filePath", "activeFile", "periodicNote"]>;
     /** The content for the modification. Must be a string for whole-file operations. */
@@ -48,7 +48,7 @@ declare const ObsidianUpdateFileRegistrationSchema: z.ZodObject<{
  * The shape of the registration schema, used by `server.tool` for basic validation.
  * @see ObsidianUpdateFileRegistrationSchema
  */
-export declare const ObsidianUpdateFileInputSchemaShape: {
+export declare const ObsidianUpdateNoteInputSchemaShape: {
     /** Specifies the target note: 'filePath' (requires targetIdentifier), 'activeFile' (currently open file), or 'periodicNote' (requires targetIdentifier with period like 'daily'). */
     targetType: z.ZodEnum<["filePath", "activeFile", "periodicNote"]>;
     /** The content for the modification. Must be a string for whole-file operations. */
@@ -71,13 +71,13 @@ export declare const ObsidianUpdateFileInputSchemaShape: {
  * received by the tool handler *before* refinement.
  * @see ObsidianUpdateFileRegistrationSchema
  */
-export type ObsidianUpdateFileRegistrationInput = z.infer<typeof ObsidianUpdateFileRegistrationSchema>;
+export type ObsidianUpdateNoteRegistrationInput = z.infer<typeof ObsidianUpdateNoteRegistrationSchema>;
 /**
  * Refined Zod schema used internally within the tool's logic for strict validation.
  * It builds upon `WholeFileUpdateSchema` and adds cross-field validation rules using `.refine()`.
  * This ensures that `targetIdentifier` is provided and valid when required by `targetType`.
  */
-export declare const ObsidianUpdateFileInputSchema: z.ZodEffects<z.ZodObject<{
+export declare const ObsidianUpdateNoteInputSchema: z.ZodEffects<z.ZodObject<{
     /** Specifies the type of target note. */
     targetType: z.ZodEnum<["filePath", "activeFile", "periodicNote"]>;
     /** The content to use for the modification. Must be a string for whole-file operations. */
@@ -140,7 +140,7 @@ export declare const ObsidianUpdateFileInputSchema: z.ZodEffects<z.ZodObject<{
  * TypeScript type inferred from the *refined* input schema (`ObsidianUpdateFileInputSchema`).
  * This type represents the validated and structured input used within the core processing logic.
  */
-export type ObsidianUpdateFileInput = z.infer<typeof ObsidianUpdateFileInputSchema>;
+export type ObsidianUpdateNoteInput = z.infer<typeof ObsidianUpdateNoteInputSchema>;
 /**
  * Represents the structure of file statistics after formatting, including
  * human-readable timestamps and an estimated token count.
@@ -157,7 +157,7 @@ type FormattedStat = {
  * Defines the structure of the successful response returned by the `processObsidianUpdateFile` function.
  * This object is typically serialized to JSON and sent back to the client.
  */
-export interface ObsidianUpdateFileResponse {
+export interface ObsidianUpdateNoteResponse {
     /** Indicates whether the operation was successful. */
     success: boolean;
     /** A human-readable message describing the outcome of the operation. */
@@ -178,6 +178,6 @@ export interface ObsidianUpdateFileResponse {
  * @returns {Promise<ObsidianUpdateFileResponse>} A promise resolving to the structured success response.
  * @throws {McpError} Throws an McpError if validation fails or the API interaction results in an error.
  */
-export declare const processObsidianUpdateFile: (params: ObsidianUpdateFileInput, // Use the refined, validated type
-context: RequestContext, obsidianService: ObsidianRestApiService, vaultCacheService: VaultCacheService | undefined) => Promise<ObsidianUpdateFileResponse>;
+export declare const processObsidianUpdateNote: (params: ObsidianUpdateNoteInput, // Use the refined, validated type
+context: RequestContext, obsidianService: ObsidianRestApiService, vaultCacheService: VaultCacheService | undefined) => Promise<ObsidianUpdateNoteResponse>;
 export {};

package/dist/mcp-server/tools/{obsidianUpdateFileTool → obsidianUpdateNoteTool}/logic.js

@@ -79,7 +79,7 @@ const WholeFileUpdateSchema = BaseUpdateSchema.extend({
  * relying on the refined schema (`ObsidianUpdateFileInputSchema`) for stricter validation
  * within the handler logic.
  */
-const ObsidianUpdateFileRegistrationSchema = z
+const ObsidianUpdateNoteRegistrationSchema = z
     .object({
     /** Specifies the target note: 'filePath' (requires targetIdentifier), 'activeFile' (currently open file), or 'periodicNote' (requires targetIdentifier with period like 'daily'). */
     targetType: TargetTypeSchema,
@@ -122,7 +122,7 @@ const ObsidianUpdateFileRegistrationSchema = z
  * The shape of the registration schema, used by `server.tool` for basic validation.
  * @see ObsidianUpdateFileRegistrationSchema
  */
-export const ObsidianUpdateFileInputSchemaShape = ObsidianUpdateFileRegistrationSchema.shape;
+export const ObsidianUpdateNoteInputSchemaShape = ObsidianUpdateNoteRegistrationSchema.shape;
 // ====================================================================================
 // Refined Schema for Internal Logic and Strict Validation
 // ====================================================================================
@@ -131,7 +131,7 @@ export const ObsidianUpdateFileInputSchemaShape = ObsidianUpdateFileRegistration
  * It builds upon `WholeFileUpdateSchema` and adds cross-field validation rules using `.refine()`.
  * This ensures that `targetIdentifier` is provided and valid when required by `targetType`.
  */
-export const ObsidianUpdateFileInputSchema = WholeFileUpdateSchema.refine((data) => {
+export const ObsidianUpdateNoteInputSchema = WholeFileUpdateSchema.refine((data) => {
     // Rule 1: If targetType is 'filePath' or 'periodicNote', targetIdentifier must be provided.
     if ((data.targetType === "filePath" || data.targetType === "periodicNote") &&
         !data.targetIdentifier) {
@@ -207,9 +207,9 @@ async function getFinalState(targetType, targetIdentifier, period, obsidianServi
  * @returns {Promise<ObsidianUpdateFileResponse>} A promise resolving to the structured success response.
  * @throws {McpError} Throws an McpError if validation fails or the API interaction results in an error.
  */
-export const processObsidianUpdateFile = async (params, // Use the refined, validated type
+export const processObsidianUpdateNote = async (params, // Use the refined, validated type
 context, obsidianService, vaultCacheService) => {
-    logger.debug(`Processing obsidian_update_file request (wholeFile mode)`, {
+    logger.debug(`Processing obsidian_update_note request (wholeFile mode)`, {
         ...context,
         targetType: params.targetType,
         wholeFileMode: params.wholeFileMode,
@@ -251,7 +251,7 @@ context, obsidianService, vaultCacheService) => {
                 existsBefore = true;
                 logger.debug(`Target exists before operation.`, checkContext);
             }, {
-                operationName: "existenceCheckObsidianUpdateFile",
+                operationName: "existenceCheckObsidianUpdateNote",
                 context: checkContext,
                 maxRetries: 3, // Total attempts: 1 initial + 2 retries
                 delayMs: 250,
@@ -263,7 +263,7 @@ context, obsidianService, vaultCacheService) => {
                         params.createIfNeeded;
                     if (error instanceof McpError &&
                         error.code === BaseErrorCode.NOT_FOUND) {
-                        logger.debug(`existenceCheckObsidianUpdateFile: shouldRetry=${should} for NOT_FOUND (createIfNeeded: ${params.createIfNeeded})`, checkContext);
+                        logger.debug(`existenceCheckObsidianUpdateNote: shouldRetry=${should} for NOT_FOUND (createIfNeeded: ${params.createIfNeeded})`, checkContext);
                     }
                     return should;
                 },

package/dist/mcp-server/tools/{obsidianUpdateFileTool → obsidianUpdateNoteTool}/registration.d.ts

@@ -1,7 +1,7 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { ObsidianRestApiService, VaultCacheService } from "../../../services/obsidianRestAPI/index.js";
 /**
- * Registers the 'obsidian_update_file' tool with the MCP server.
+ * Registers the 'obsidian_update_note' tool with the MCP server.
  *
  * This tool allows modification of Obsidian notes (specified by file path,
  * the active file, or a periodic note) using whole-file operations:
@@ -18,4 +18,4 @@ import { ObsidianRestApiService, VaultCacheService } from "../../../services/obs
  * @returns {Promise<void>} A promise that resolves when the tool registration is complete or rejects on error.
  * @throws {McpError} Throws an McpError if registration fails critically.
  */
-export declare const registerObsidianUpdateFileTool: (server: McpServer, obsidianService: ObsidianRestApiService, vaultCacheService: VaultCacheService | undefined) => Promise<void>;
+export declare const registerObsidianUpdateNoteTool: (server: McpServer, obsidianService: ObsidianRestApiService, vaultCacheService: VaultCacheService | undefined) => Promise<void>;

package/dist/mcp-server/tools/{obsidianUpdateFileTool → obsidianUpdateNoteTool}/registration.js

@@ -1,9 +1,9 @@
 import { BaseErrorCode, McpError } from "../../../types-global/errors.js";
 import { ErrorHandler, logger, requestContextService, } from "../../../utils/index.js";
 // Import the Zod schema for validation and the core processing logic
-import { ObsidianUpdateFileInputSchema, ObsidianUpdateFileInputSchemaShape, processObsidianUpdateFile, } from "./logic.js";
+import { ObsidianUpdateNoteInputSchema, ObsidianUpdateNoteInputSchemaShape, processObsidianUpdateNote, } from "./logic.js";
 /**
- * Registers the 'obsidian_update_file' tool with the MCP server.
+ * Registers the 'obsidian_update_note' tool with the MCP server.
  *
  * This tool allows modification of Obsidian notes (specified by file path,
  * the active file, or a periodic note) using whole-file operations:
@@ -20,26 +20,26 @@ import { ObsidianUpdateFileInputSchema, ObsidianUpdateFileInputSchemaShape, proc
  * @returns {Promise<void>} A promise that resolves when the tool registration is complete or rejects on error.
  * @throws {McpError} Throws an McpError if registration fails critically.
  */
-export const registerObsidianUpdateFileTool = async (server, obsidianService, vaultCacheService) => {
-    const toolName = "obsidian_update_file";
+export const registerObsidianUpdateNoteTool = async (server, obsidianService, vaultCacheService) => {
+    const toolName = "obsidian_update_note";
     const toolDescription = "Tool to modify Obsidian notes (specified by file path, the active file, or a periodic note) using whole-file operations: 'append', 'prepend', or 'overwrite'. Options allow creating missing files/targets and controlling overwrite behavior. Returns success status, message, a formatted timestamp string, file stats (stats), and optionally the final file content.";
     // Create a context for the registration process itself for better traceability.
     const registrationContext = requestContextService.createRequestContext({
-        operation: "RegisterObsidianUpdateFileTool",
+        operation: "RegisterObsidianUpdateNoteTool",
         toolName: toolName,
-        module: "ObsidianUpdateFileRegistration", // Identify the module performing registration
+        module: "ObsidianUpdateNoteRegistration", // Identify the module performing registration
     });
     logger.info(`Attempting to register tool: ${toolName}`, registrationContext);
     // Wrap the registration in a tryCatch block for robust error handling during setup.
     await ErrorHandler.tryCatch(async () => {
         // Use the high-level SDK method for tool registration.
         // This handles schema generation, validation, and routing automatically.
-        server.tool(toolName, toolDescription, ObsidianUpdateFileInputSchemaShape, // Provide the Zod schema shape for input validation.
+        server.tool(toolName, toolDescription, ObsidianUpdateNoteInputSchemaShape, // Provide the Zod schema shape for input validation.
         /**
-         * The handler function executed when the 'obsidian_update_file' tool is called.
+         * The handler function executed when the 'obsidian_update_note' tool is called.
          *
-         * @param {ObsidianUpdateFileRegistrationInput} params - The raw input parameters received from the client,
-         *   matching the structure defined by ObsidianUpdateFileInputSchemaShape.
+         * @param {ObsidianUpdateNoteRegistrationInput} params - The raw input parameters received from the client,
+         *   matching the structure defined by ObsidianUpdateNoteInputSchemaShape.
          * @returns {Promise<CallToolResult>} A promise resolving to the structured result for the MCP client,
          *   containing either the successful response data or an error indication.
          */
@@ -47,7 +47,7 @@ export const registerObsidianUpdateFileTool = async (server, obsidianService, va
             // Create a specific context for this handler invocation.
             const handlerContext = requestContextService.createRequestContext({
                 parentContext: registrationContext, // Link to the registration context
-                operation: "HandleObsidianUpdateFileRequest",
+                operation: "HandleObsidianUpdateNoteRequest",
                 toolName: toolName,
                 params: {
                     // Log key parameters for easier debugging, content is omitted for brevity/security
@@ -67,10 +67,10 @@ export const registerObsidianUpdateFileTool = async (server, obsidianService, va
                 // This ensures type safety and adherence to constraints defined in logic.ts.
                 // While server.tool performs initial validation based on the shape,
                 // this step applies any stricter rules or refinements from the full schema.
-                const validatedParams = ObsidianUpdateFileInputSchema.parse(params);
+                const validatedParams = ObsidianUpdateNoteInputSchema.parse(params);
                 // Delegate the actual file update logic to the dedicated processing function.
                 // Pass the validated parameters, the handler context, and the Obsidian service instance.
-                const response = await processObsidianUpdateFile(validatedParams, handlerContext, obsidianService, vaultCacheService);
+                const response = await processObsidianUpdateNote(validatedParams, handlerContext, obsidianService, vaultCacheService);
                 logger.debug(`'${toolName}' (wholeFile mode) processed successfully`, handlerContext);
                 // Format the successful response from the logic function into the MCP CallToolResult structure.
                 // The response object (containing status, message, timestamp, stat, etc.) is serialized to JSON.

package/dist/mcp-server/transports/{authentication → auth/core}/authContext.d.ts

@@ -5,10 +5,10 @@
  * from the middleware layer down to the tool and resource handlers without
  * drilling props.
  *
- * @module src/mcp-server/transports/authentication/authContext
+ * @module src/mcp-server/transports/auth/core/authContext
  */
 import { AsyncLocalStorage } from "async_hooks";
-import type { AuthInfo } from "./types.js";
+import type { AuthInfo } from "./authTypes.js";
 /**
  * Defines the structure of the store used within the AsyncLocalStorage.
  * It holds the authentication information for the current request context.

package/dist/mcp-server/transports/{authentication → auth/core}/authContext.js

@@ -5,7 +5,7 @@
  * from the middleware layer down to the tool and resource handlers without
  * drilling props.
  *
- * @module src/mcp-server/transports/authentication/authContext
+ * @module src/mcp-server/transports/auth/core/authContext
  */
 import { AsyncLocalStorage } from "async_hooks";
 /**

package/dist/mcp-server/transports/{authentication/types.d.ts → auth/core/authTypes.d.ts}

@@ -1,6 +1,6 @@
 /**
  * @fileoverview Shared types for authentication middleware.
- * @module src/mcp-server/transports/authentication/types
+ * @module src/mcp-server/transports/auth/core/auth.types
  */
 import type { AuthInfo as SdkAuthInfo } from "@modelcontextprotocol/sdk/server/auth/types.js";
 /**

package/dist/mcp-server/transports/{authentication/types.js → auth/core/authTypes.js}

@@ -1,5 +1,5 @@
 /**
  * @fileoverview Shared types for authentication middleware.
- * @module src/mcp-server/transports/authentication/types
+ * @module src/mcp-server/transports/auth/core/auth.types
  */
 export {};

package/dist/mcp-server/transports/{authentication → auth/core}/authUtils.d.ts

@@ -1,7 +1,7 @@
 /**
  * @fileoverview Provides utility functions for authorization, specifically for
  * checking token scopes against required permissions for a given operation.
- * @module src/mcp-server/transports/authentication/authUtils
+ * @module src/mcp-server/transports/auth/core/authUtils
  */
 /**
  * Checks if the current authentication context contains all the specified scopes.

package/dist/mcp-server/transports/{authentication → auth/core}/authUtils.js

@@ -1,10 +1,10 @@
 /**
  * @fileoverview Provides utility functions for authorization, specifically for
  * checking token scopes against required permissions for a given operation.
- * @module src/mcp-server/transports/authentication/authUtils
+ * @module src/mcp-server/transports/auth/core/authUtils
  */
-import { BaseErrorCode, McpError } from "../../../types-global/errors.js";
-import { logger, requestContextService } from "../../../utils/index.js";
+import { BaseErrorCode, McpError } from "../../../../types-global/errors.js";
+import { logger, requestContextService } from "../../../../utils/index.js";
 import { authContext } from "./authContext.js";
 /**
  * Checks if the current authentication context contains all the specified scopes.