@sunub/obsidian-mcp-server 0.0.2 → 0.0.4

package/build/config.js

@@ -0,0 +1,55 @@
+import { existsSync, statSync } from "node:fs";
+import { resolve } from "node:path";
+import { Command } from "commander";
+import dotenv from "dotenv";
+import { z } from "zod/v4";
+dotenv.config({ debug: false, quiet: true });
+const vaultPathSchema = z
+    .string()
+    .min(1, "Vault path는 비어 있을 수 없습니다.")
+    .trim()
+    .transform((val) => resolve(val)) // 입력받은 경로를 절대 경로로 변환
+    .refine((val) => existsSync(val), {
+    message: "파일 시스템에 해당 경로가 존재하지 않습니다.",
+})
+    .refine((val) => {
+    try {
+        return statSync(val).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}, {
+    message: "지정된 경로가 디렉토리가 아닙니다.",
+});
+export const configSchema = z.object({
+    vaultPath: vaultPathSchema,
+    loggingLevel: z.enum(["debug", "info", "warn", "error"]).default("info"),
+});
+const state = {
+    vaultPath: process.env.VAULT_DIR_PATH || "",
+    loggingLevel: "info",
+};
+export function getOptions() {
+    const program = new Command()
+        .name("obsidian-mcp-server")
+        .description("MCP Server for Obsidian Vault")
+        .option("--vault-path <path>", "Path to the Obsidian vault directory", process.env.VAULT_DIR_PATH ?? "")
+        .option("--logging-level <level>", "Logging level (debug, info, warn, error)", process.env.LOGGING_LEVEL ?? "info")
+        .allowUnknownOption()
+        .parse(process.argv);
+    const options = program.opts();
+    const parseResult = configSchema.safeParse(options);
+    if (!parseResult.success) {
+        console.error("Configuration Error:");
+        parseResult.error.issues.forEach((issue) => {
+            console.error(` - ${issue.path.join(".")}: ${issue.message}`);
+        });
+        console.info("\n사용 방법: Environment variables 에 VAULT_DIR_PATH 설정 또는 명령줄 인수 --vault-path <path>를 통해 올바른 구성을 제공하세요.");
+        return false;
+    }
+    state.vaultPath = parseResult.data.vaultPath;
+    state.loggingLevel = parseResult.data.loggingLevel;
+    return state;
+}
+export default state;

package/build/index.js

@@ -1,10 +1,17 @@
+#!/usr/bin/env node
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { getOptions } from "./config.js";
 import createMcpServer from "./server.js";
 export default function smitheryEntryPoint() {
     const server = createMcpServer();
     return server.server;
 }
 async function main() {
+    const options = getOptions();
+    if (!options) {
+        console.error("올바르지 않은 설정으로 인해 서버를 시작할 수 없습니다.");
+        process.exit(1);
+    }
     try {
         const server = createMcpServer();
         const transport = new StdioServerTransport();

package/build/tools/create_document_with_properties/index.js

@@ -1,5 +1,5 @@
+import state from "../../config.js";
 import { getGlobalVaultManager } from "../../utils/getVaultManager.js";
-import { getParsedVaultPath } from "../../utils/parseVaultPath.js";
 import { execute as writePropertyExecute } from "../write_property/index.js";
 import { createDocumentWithPropertiesParamsSchema, } from "./params.js";
 export const name = "create_document_with_properties";
@@ -23,7 +23,7 @@ export const register = (mcpServer) => {
     }, execute);
 };
 export const execute = async (params) => {
-    const vaultDirPath = getParsedVaultPath();
+    const vaultDirPath = state.vaultPath;
     if (!vaultDirPath) {
         return {
             isError: true,

package/build/tools/organize_attachments/index.js

@@ -1,5 +1,5 @@
+import state from "../../config.js";
 import { getGlobalVaultManager } from "../../utils/getVaultManager.js";
-import { getParsedVaultPath } from "../../utils/parseVaultPath.js";
 import { organizeAttachmentsParamsSchema, } from "./params.js";
 import { genreateOrganizationTasks } from "./utils.js";
 export const name = "organize_attachments";
@@ -33,7 +33,7 @@ export const register = (mcpServer) => {
     }, execute);
 };
 export const execute = async (params) => {
-    const vaultDirPath = getParsedVaultPath();
+    const vaultDirPath = state.vaultPath;
     if (!vaultDirPath) {
         return {
             isError: true,

package/build/tools/vault/index.js

@@ -1,5 +1,5 @@
+import state from "../../config.js";
 import { getGlobalVaultManager } from "../../utils/getVaultManager.js";
-import { getParsedVaultPath } from "../../utils/parseVaultPath.js";
 import { obsidianContentQueryParamsZod, } from "./params.js";
 import { listAllDocuments, readSpecificFile, searchDocuments, statsAllDocuments, } from "./utils.js";
 export const name = "vault";
@@ -30,7 +30,7 @@ export const register = (mcpServer) => {
     }, execute);
 };
 export const execute = async (params) => {
-    const vaultDirPath = getParsedVaultPath();
+    const vaultDirPath = state.vaultPath;
     // Vault 경로 검증
     if (!vaultDirPath) {
         return {

package/build/tools/write_property/index.js

@@ -1,5 +1,5 @@
+import state from "../../config.js";
 import { getGlobalVaultManager } from "../../utils/getVaultManager.js";
-import { getParsedVaultPath } from "../../utils/parseVaultPath.js";
 import { obsidianPropertyParamsSchema, } from "./params.js";
 export const name = "write_property";
 export const annotations = {
@@ -61,7 +61,7 @@ export const register = (mcpServer) => {
 };
 export const execute = async (params) => {
     const response = { content: [], isError: false };
-    const vaultDirPath = getParsedVaultPath();
+    const vaultDirPath = state.vaultPath;
     if (!vaultDirPath) {
         response.content.push({
             type: "text",

package/build/utils/getVaultManager.js

@@ -1,11 +1,11 @@
-import { getParsedVaultPath } from "./parseVaultPath.js";
+import state from "../config.js";
 import { VaultManager } from "./VaultManager.js";
 let instance = null;
 export function getGlobalVaultManager() {
     if (instance) {
         return instance;
     }
-    const vaultPath = getParsedVaultPath();
+    const vaultPath = state.vaultPath;
     if (!vaultPath) {
         throw new Error("VAULT_DIR_PATH environment variable is not set");
     }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sunub/obsidian-mcp-server",
-	"version": "0.0.2",
+	"version": "0.0.4",
 	"description": "A server for the Obsidian Model Context Protocol.",
 	"keywords": [
 		"obsidian",
@@ -39,6 +39,7 @@
 	"license": "ISC",
 	"dependencies": {
 		"@modelcontextprotocol/sdk": "^1.17.5",
+		"commander": "^14.0.2",
 		"dotenv": "^17.2.2",
 		"gray-matter": "^4.0.3",
 		"zod": "^3.25.76"

package/build/utils/parseVaultPath.js

@@ -1,18 +0,0 @@
-import os from "node:os";
-import dotenv from "dotenv";
-dotenv.config({ debug: false });
-export const VAULT_DIR_PATH = process.env.VAULT_DIR_PATH || "";
-function isWindowsPath(path) {
-    return os.platform() === "win32" && /^[a-zA-Z]:\\/.test(path);
-}
-function parseWindosPathToLinux(path) {
-    if (!isWindowsPath(path)) {
-        throw new Error("Not a valid Windows path");
-    }
-    const driveLetter = path[0].toLowerCase();
-    const pathWithoutDrive = path.slice(2).replace(/\\/g, "/");
-    return `/mnt/${driveLetter}/${pathWithoutDrive}`;
-}
-export const getParsedVaultPath = () => isWindowsPath(VAULT_DIR_PATH)
-    ? parseWindosPathToLinux(VAULT_DIR_PATH)
-    : VAULT_DIR_PATH;