@sunub/obsidian-mcp-server 0.3.15 → 0.3.17

package/{build → dist}/config.d.ts

@@ -1,4 +1,4 @@
-import type { ObsidianMcpConfig } from "@sunub/core";
+import type { ObsidianMcpConfig } from "@sunub/obsidian-mcp-core";
 declare const state: ObsidianMcpConfig;
 export declare function getOptions(): ObsidianMcpConfig | false;
 export declare function setLocalLLMEnvSetting(): void;

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AA0BlE,QAAA,MAAM,KAAK,EAAE,iBAEkC,CAAC;AAEhD,wBAAgB,UAAU,IAAI,iBAAiB,GAAG,KAAK,CA2DtD;AAED,wBAAgB,qBAAqB,SAIpC;AAED,eAAe,KAAK,CAAC"}

package/dist/config.js

@@ -0,0 +1,59 @@
+import { env } from "@huggingface/transformers";
+import { configSchema } from "@sunub/obsidian-mcp-core";
+import { Command } from "commander";
+import dotenv from "dotenv";
+import { MODELS_DIR } from "./utils/constants.js";
+dotenv.config({ debug: false });
+const _rawConfig = {
+    vaultPath: process.env["VAULT_DIR_PATH"] || "",
+    loggingLevel: "info",
+    llmApiUrl: process.env["LLM_API_URL"] || "http://127.0.0.1:8080",
+    llmEmbeddingApiUrl: process.env["LLM_EMBEDDING_API_URL"] || "http://127.0.0.1:8081",
+    llmEmbeddingModel: process.env["LLM_EMBEDDING_MODEL"] || "nomic-embed-text",
+    llmChatModel: process.env["LLM_CHAT_MODEL"] || "llama3",
+    llmRerankerApiUrl: process.env["LLM_RERANKER_API_URL"] || "http://127.0.0.1:8082",
+};
+const _parseResult = configSchema.safeParse(_rawConfig);
+// safeParse를 사용하여 모듈 로드 시점에 throw하지 않는다.
+// 유효한 환경(프로덕션 CLI)에서는 getOptions()가 전체 검증을 수행한다.
+// 테스트 환경에서는 beforeAll에서 state.vaultPath를 직접 할당한다.
+const state = _parseResult.success
+    ? _parseResult.data
+    : _rawConfig;
+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")
+        .option("--llm-api-url <url>", "LLM Chat API URL", process.env["LLM_API_URL"] ?? "http://127.0.0.1:8080")
+        .option("--llm-embedding-api-url <url>", "LLM Embedding API URL", process.env["LLM_EMBEDDING_API_URL"] ?? "http://127.0.0.1:8081")
+        .option("--llm-embedding-model <model>", "LLM Embedding Model", process.env["LLM_EMBEDDING_MODEL"] ?? "nomic-embed-text")
+        .option("--llm-chat-model <model>", "LLM Chat Model", process.env["LLM_CHAT_MODEL"] ?? "llama3")
+        .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.error("\n사용 방법: Environment variables 에 VAULT_DIR_PATH 설정 또는 명령줄 인수 --vault-path <path>를 통해 올바른 구성을 제공하세요.");
+        return false;
+    }
+    state.vaultPath = parseResult.data.vaultPath;
+    state.loggingLevel = parseResult.data.loggingLevel;
+    state.llmApiUrl = parseResult.data.llmApiUrl;
+    state.llmEmbeddingApiUrl = parseResult.data.llmEmbeddingApiUrl;
+    state.llmEmbeddingModel = parseResult.data.llmEmbeddingModel;
+    state.llmChatModel = parseResult.data.llmChatModel;
+    return state;
+}
+export function setLocalLLMEnvSetting() {
+    env.localModelPath = MODELS_DIR;
+    env.cacheDir = MODELS_DIR;
+    env.allowRemoteModels = false;
+}
+export default state;
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/db.js

@@ -0,0 +1,58 @@
+import path from "node:path";
+import * as lancedb from "@lancedb/lancedb";
+import dotenv from "dotenv";
+import state from "./config.js";
+import { llmClient } from "./utils/LLMClient.js";
+dotenv.config();
+const log = (...args) => console.log(...args);
+async function runTestSearch() {
+    try {
+        // 1. 실제 Obsidian Vault 내의 Vector DB 경로 설정
+        if (!state.vaultPath) {
+            throw new Error("VAULT_DIR_PATH is not set.");
+        }
+        const dbPath = path.join(state.vaultPath, ".obsidian", "vector_cache");
+        log(`\n📂 연결된 금고: ${state.vaultPath}`);
+        log(`🗄️ DB 경로: ${dbPath}`);
+        const db = await lancedb.connect(dbPath);
+        const tableNames = await db.tableNames();
+        if (!tableNames.includes("obsidian_chunks")) {
+            log("❌ 'obsidian_chunks' 테이블을 찾을 수 없습니다. 인덱싱이 먼저 필요합니다.");
+            return;
+        }
+        // 2. 실제 서버가 사용하는 테이블 열기
+        const table = await db.openTable("obsidian_chunks");
+        const queryText = "LCP";
+        log(`🌐 임베딩 서버: ${state.llmEmbeddingApiUrl}`);
+        log(`🔍 Searching for: "${queryText}" in actual Obsidian index...`);
+        // 3. LLMClient를 사용하여 임베딩 생성 (접두사 및 정규화 자동 처리)
+        const queryVector = await llmClient.generateEmbedding(`search_query: ${queryText}`);
+        // 4. LanceDB 벡터 검색 수행
+        const searchResults = await table
+            .vectorSearch(queryVector)
+            .limit(5)
+            .toArray();
+        // 5. 결과 출력
+        if (searchResults.length === 0) {
+            log("No relevant documents found.");
+        }
+        else {
+            log(`\n✅ Found ${searchResults.length} results:`);
+            searchResults.forEach((res, i) => {
+                log(`\n[Result ${i + 1}] Distance: ${res._distance.toFixed(4)}`);
+                log(`FileName: ${res.fileName}`);
+                log(`Path: ${res.filePath}`);
+                log(`Content Sample: ${res.content.substring(0, 200).replace(/\n/g, " ")}...`);
+                if (res.metadata) {
+                    log(`Metadata Title: ${res.metadata.title}`);
+                }
+                log("--------------------------------------------------");
+            });
+        }
+    }
+    catch (error) {
+        console.error("❌ 테스트 검색 중 오류 발생:", error);
+    }
+}
+runTestSearch();
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

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

package/dist/index.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import chalk from "chalk";
+import { getOptions, setLocalLLMEnvSetting } from "./config.js";
+import createMcpServer from "./server.js";
+import { localEmbedder } from "./utils/Embedder.js";
+import { localReranker } from "./utils/LocalReranker.js";
+import { vaultWatcher } from "./utils/VaultWatcher.js";
+async function main() {
+    const options = getOptions();
+    if (!options) {
+        console.error(chalk.red("올바르지 않은 설정으로 인해 서버를 시작할 수 없습니다."));
+        process.exit(1);
+    }
+    setLocalLLMEnvSetting();
+    // 로컬 모델 상태 확인 및 출력
+    const [embedderReady, rerankerReady] = await Promise.all([
+        localEmbedder.checkModelPresence(),
+        localReranker.checkModelPresence(),
+    ]);
+    console.error(chalk.cyan.bold("\n🚀 Obsidian MCP Server Startup"));
+    console.error(chalk.dim("----------------------------------"));
+    console.error(`${chalk.bold("• Vault Path:")} ${chalk.blue(options.vaultPath)}`);
+    console.error(`${chalk.bold("• Local Embedder:")} ${embedderReady ? chalk.green("✅ Ready") : chalk.yellow("⚠️ Missing")}`);
+    console.error(`${chalk.bold("• Local Reranker:")} ${rerankerReady ? chalk.green("✅ Ready") : chalk.yellow("⚠️ Missing")}`);
+    if (embedderReady && rerankerReady) {
+        console.error(chalk.green.bold("✔ High-performance Hybrid Search is ENABLED\n"));
+    }
+    else {
+        console.error(chalk.yellow("ℹ Basic Keyword Search is active. Run 'bunx obsidian-mcp-setup' to enable Hybrid Search.\n"));
+    }
+    try {
+        if (!options.vaultPath) {
+            throw new Error("Vault path is required.");
+        }
+        vaultWatcher.start(options.vaultPath).catch((error) => {
+            console.error(chalk.red("[VaultWatcher] Background indexing error:"), error);
+        });
+        const server = createMcpServer();
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+    }
+    catch (error) {
+        console.error(chalk.red("Failed to start MCP server:"), error);
+        process.exit(1);
+    }
+}
+main().catch((error) => {
+    console.error(chalk.red("main() 함수에서 치명적인 오류가 발생했습니다:"), error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/server.js

@@ -0,0 +1,42 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import tools from "./tools/index.js";
+import pkg from "../package.json" with { type: "json" };
+export default function createMcpServer() {
+    const mcpServer = new McpServer({
+        version: pkg.version,
+        name: "obsidian-mcp-server",
+        title: "Obsidian MCP Server",
+    }, {
+        capabilities: {
+            logging: {},
+            tools: { listChanged: false },
+        },
+        instructions: `
+	        This server provides access to Obsidian vault documents and related tools.
+	        
+	        Available tools:
+	        - vault: Search, read, list, and index documents in the vault.
+	          * action="search": Unified hybrid search (Keyword + Semantic + Reranking). Automatically falls back to keyword search if local models are missing.
+	          * action="read": Read a specific document's content and metadata.
+	          * action="list_all": List all documents in the vault.
+	          * action="index_vault_to_vectordb": Manually trigger a full vault re-indexing for semantic search.
+	        - generate_property: Generate frontmatter property suggestions from document content.
+	        - write_property: Write frontmatter properties to a markdown file.
+	        - create_document_with_properties: Two-step workflow for AI-generated properties and write.
+	        - organize_attachments: Move linked attachments and update markdown links.
+	        
+	        Environment requirements:
+	        - VAULT_DIR_PATH: Path to your Obsidian vault directory.
+	        - LLM_API_URL: (Optional) Remote chat server URL (default: http://127.0.0.1:8080).
+	        - LLM_EMBEDDING_API_URL: (Optional) Remote embedding server URL (default: http://127.0.0.1:8081).
+	        
+	        Local Search Optimization:
+	        - To enable high-performance local hybrid search, run 'bunx obsidian-mcp-setup' once.
+	      `,
+    });
+    for (const tool of Object.values(tools)) {
+        tool.register(mcpServer);
+    }
+    return mcpServer;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,MAAM,kBAAkB,CAAC;AACrC,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAExD,MAAM,CAAC,OAAO,UAAU,eAAe;IACtC,MAAM,SAAS,GAAG,IAAI,SAAS,CAC9B;QACC,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,IAAI,EAAE,qBAAqB;QAC3B,KAAK,EAAE,qBAAqB;KAC5B,EACD;QACC,YAAY,EAAE;YACb,OAAO,EAAE,EAAE;YACX,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE;SAC7B;QACD,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;QAqBT;KACL,CACD,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACzC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,SAAS,CAAC;AAClB,CAAC"}

package/dist/setup.js

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+import { fileURLToPath } from "node:url";
+import { env, pipeline } from "@huggingface/transformers";
+import chalk from "chalk";
+import inquirer from "inquirer";
+import ora from "ora";
+import { APP_DATA_DIR, ensureAppDataDirs, MODELS_DIR, } from "./utils/constants.js";
+env.localModelPath = MODELS_DIR;
+env.cacheDir = MODELS_DIR;
+env.allowRemoteModels = false;
+async function checkModelStatus(name, type) {
+    try {
+        await pipeline(type, name, {
+            local_files_only: true,
+        });
+        return true;
+    }
+    catch (_e) {
+        return false;
+    }
+}
+export async function setup(options = { force: false }) {
+    console.log(chalk.cyan.bold("\n🚀 Obsidian MCP Server: Local Model Setup\n"));
+    ensureAppDataDirs();
+    const models = [
+        {
+            name: "Xenova/bge-reranker-base",
+            type: "text-classification",
+            label: "BGE Reranker (Base)",
+            desc: "Improves search relevance by re-ordering results.",
+        },
+        {
+            name: "Xenova/paraphrase-multilingual-MiniLM-L12-v2",
+            type: "feature-extraction",
+            label: "Multilingual MiniLM",
+            desc: "Provides deep understanding of multilingual documents.",
+        },
+    ];
+    console.log(chalk.blue.bold("🔍 Current Model Status:"));
+    const statusList = [];
+    for (const m of models) {
+        const spinner = ora(`Checking ${m.label}...`).start();
+        const isReady = await checkModelStatus(m.name, m.type);
+        if (isReady) {
+            spinner.succeed(`${chalk.bold(m.label)}: ${chalk.green("Ready")}`);
+        }
+        else {
+            spinner.warn(`${chalk.bold(m.label)}: ${chalk.yellow("Not Found or Incomplete")}`);
+        }
+        statusList.push({ ...m, isReady });
+    }
+    const allReady = statusList.every((s) => s.isReady);
+    if (!options.force && allReady) {
+        return true;
+    }
+    console.log(chalk.blue.bold("\n📦 Installation Details:"));
+    console.log(`${chalk.yellow("▶")} ${chalk.bold("Model Path:")} ${chalk.cyan(MODELS_DIR)}`);
+    console.log(`${chalk.yellow("▶")} ${chalk.bold("Download Size:")} Approx. ${chalk.green("300MB")}`);
+    console.log(`${chalk.yellow("▶")} ${chalk.bold("Uninstallation:")} ${chalk.white(`rm -rf ${APP_DATA_DIR}`)}`);
+    console.log(chalk.dim("\n※ All processing happens locally. Your documents are never sent to external servers.\n"));
+    const answers = await inquirer.prompt([
+        {
+            type: "confirm",
+            name: "confirmed",
+            message: allReady
+                ? "All models are already installed. Re-verify them?"
+                : "Proceed with the installation?",
+            default: !allReady,
+        },
+    ]);
+    if (!answers.confirmed) {
+        console.log(chalk.yellow("\n👋 Setup skipped.\n"));
+        process.exit(0);
+    }
+    console.log(chalk.cyan("\n⏳ Starting processing. This may take a few minutes...\n"));
+    env.allowRemoteModels = true;
+    for (const modelInfo of models) {
+        const spinner = ora({
+            text: chalk.white(`Processing ${modelInfo.name}...`),
+            color: "cyan",
+        }).start();
+        try {
+            await pipeline(modelInfo.type, modelInfo.name);
+            spinner.succeed(chalk.green(`Successfully processed ${modelInfo.name}`));
+        }
+        catch (error) {
+            spinner.fail(chalk.red(`Failed to process ${modelInfo.name}: ${error instanceof Error ? error.message : error}`));
+        }
+    }
+    env.allowRemoteModels = false;
+    const finalCheckSpinner = ora("Verifying installation...").start();
+    const finalResults = await Promise.all(models.map((m) => checkModelStatus(m.name, m.type)));
+    if (finalResults.every((r) => r)) {
+        finalCheckSpinner.succeed(chalk.green.bold("Verification successful!"));
+        console.log(chalk.cyan.bold("\n✨ Setup complete! High-performance hybrid search is enabled.\n"));
+    }
+    else {
+        finalCheckSpinner.fail(chalk.red.bold("Verification failed."));
+        console.log(chalk.yellow("\nPlease check your internet and try again.\n"));
+    }
+    return finalResults.every((r) => r);
+}
+const isMain = process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1];
+if (isMain ||
+    process.argv[1]?.endsWith("setup.js") ||
+    process.argv[1]?.endsWith("obsidian-mcp-setup")) {
+    setup({ force: true })
+        .catch((error) => {
+        console.error(chalk.red("\n🚨 Fatal error during setup:"), error);
+        process.exit(1);
+    })
+        .then(() => process.exit(0));
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

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

package/{build → dist}/tools/create_document_with_properties/index.d.ts

@@ -1,6 +1,6 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { CallToolResult, ToolAnnotations } from "@modelcontextprotocol/sdk/types.js";
-import { type CreateDocumentWithPropertiesParams } from "@/tools/create_document_with_properties/params.js";
+import { type CreateDocumentWithPropertiesParams } from "../../tools/create_document_with_properties/params.js";
 export declare const name = "create_document_with_properties";
 export declare const annotations: ToolAnnotations;
 export declare const description = "\n  Starts and completes a two-step workflow for AI-generated frontmatter properties.\n\n  Step 1: Call this tool with sourcePath (and optional outputPath). It returns a structured instruction payload and a content preview for AI analysis.\n  Step 2: Call this same tool again with aiGeneratedProperties. The tool then writes those properties by executing the same write logic used by the 'write_property' tool.\n\n  Use this tool when an AI agent should orchestrate analysis and write in a consistent workflow.\n";

package/dist/tools/create_document_with_properties/index.js

@@ -0,0 +1,115 @@
+import state from "../../config.js";
+import { createDocumentWithPropertiesParamsSchema, } from "../../tools/create_document_with_properties/params.js";
+import { execute as writePropertyExecute } from "../../tools/write_property/index.js";
+import { createToolError } from "../../utils/createToolError.js";
+import { getGlobalVaultManager } from "../../utils/getVaultManager.js";
+export const name = "create_document_with_properties";
+export const annotations = {
+    title: "Create Document with Properties",
+    openWorldHint: true,
+};
+export const description = `
+  Starts and completes a two-step workflow for AI-generated frontmatter properties.
+
+  Step 1: Call this tool with sourcePath (and optional outputPath). It returns a structured instruction payload and a content preview for AI analysis.
+  Step 2: Call this same tool again with aiGeneratedProperties. The tool then writes those properties by executing the same write logic used by the 'write_property' tool.
+
+  Use this tool when an AI agent should orchestrate analysis and write in a consistent workflow.
+`;
+export const register = (mcpServer) => {
+    mcpServer.registerTool(name, {
+        title: annotations.title || name,
+        description: description,
+        inputSchema: createDocumentWithPropertiesParamsSchema.shape,
+        annotations: annotations,
+    }, execute);
+};
+export const execute = async (params) => {
+    const vaultDirPath = state.vaultPath;
+    if (!vaultDirPath) {
+        return createToolError("VAULT_DIR_PATH environment variable is not set", "Set VAULT_DIR_PATH to your Obsidian vault directory");
+    }
+    let vaultManager = null;
+    try {
+        vaultManager = getGlobalVaultManager();
+    }
+    catch (e) {
+        return createToolError(e.message);
+    }
+    try {
+        const targetPath = params.outputPath || params.sourcePath;
+        if (params.aiGeneratedProperties) {
+            const writeResult = await writePropertyExecute({
+                filePath: targetPath,
+                properties: params.aiGeneratedProperties,
+                quiet: params.quiet || false,
+            });
+            return writeResult;
+        }
+        const document = await vaultManager.getDocumentInfo(params.sourcePath);
+        if (document === null) {
+            return createToolError(`Source document not found: ${params.sourcePath}`, "Verify the file path and ensure the file exists. Use the vault tool with 'list_all' action to see all available files.");
+        }
+        const instructionForAI = {
+            ai_prompt: "Your task is to analyze the provided text content and create a JSON object of document properties based on the requested schema. After creating the JSON object, you MUST call the 'create_document_with_properties' tool again, passing back the original parameters along with the new 'aiGeneratedProperties' parameter containing your generated JSON.",
+            purpose: "Analyze document content and return a structured JSON object of properties.",
+            content_to_analyze: {
+                source_path: params.sourcePath,
+                content_preview: document.content.substring(0, 2000) +
+                    (document.content.length > 2000 ? "..." : ""),
+            },
+            // AI가 다시 호출해야 할 다음 작업에 대한 명확한 명세
+            next_action_required: {
+                tool_to_call: name, // 바로 이 도구('create_document_with_properties')를 다시 호출
+                parameters_to_add: {
+                    sourcePath: params.sourcePath,
+                    outputPath: params.outputPath,
+                    overwrite: params.overwrite,
+                    quiet: params.quiet,
+                    aiGeneratedProperties: "<- Insert your generated JSON object here.",
+                },
+                example_of_next_call: {
+                    tool_name: name,
+                    parameters: {
+                        sourcePath: params.sourcePath,
+                        aiGeneratedProperties: {
+                            title: "Serverless 환경에서 I/O 처리 최적화 경험기",
+                            date: "2025-04-03",
+                            tags: ["serverless", "optimization"],
+                            summary: "Promise.all, Worker를 벤치마크하며 서버리스 환경에서의 I/O 처리 최적화 경험기를 공유합니다.",
+                            slug: "serverless-io-optimization",
+                            category: "code",
+                            completed: true,
+                        },
+                    },
+                },
+            },
+        };
+        return {
+            isError: false,
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(instructionForAI, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return createToolError(`Failed to create workflow instruction: ${error instanceof Error ? error.message : String(error)}`);
+    }
+};
+const shorthandDescription = {
+    ko: "AI 기반 프론트매터 생성 및 적용을 위한 2단계 통합 워크플로우 도구입니다. 첫 번째 호출 시 파일 경로를 통해 문서 내용과 지침을 반환하며, 두 번째 호출 시 생성된 속성값을 받아 실제 문서에 기록합니다.",
+    en: "Orchestrates a two-step workflow for AI-generated frontmatter properties. Step 1 retrieves a content preview and schema instructions via file path. Step 2 takes the AI-generated properties and writes them directly to the file. Ideal for end-to-end automation.",
+};
+export default {
+    name,
+    description,
+    annotations,
+    inputSchema: createDocumentWithPropertiesParamsSchema.shape,
+    execute,
+    register,
+    shorthandDescription,
+};
+//# sourceMappingURL=index.js.map

package/dist/tools/create_document_with_properties/index.js.map

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

package/{build → dist}/tools/create_document_with_properties/params.d.ts

@@ -33,8 +33,8 @@ export declare const createDocumentWithPropertiesParamsSchema: z.ZodObject<{
     }>>>;
     quiet: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, "strip", z.ZodTypeAny, {
-    quiet: boolean;
     sourcePath: string;
+    quiet: boolean;
     overwrite?: boolean | undefined;
     outputPath?: string | undefined;
     aiGeneratedProperties?: {
@@ -49,7 +49,6 @@ export declare const createDocumentWithPropertiesParamsSchema: z.ZodObject<{
     } | undefined;
 }, {
     sourcePath: string;
-    quiet?: boolean | undefined;
     overwrite?: boolean | undefined;
     outputPath?: string | undefined;
     aiGeneratedProperties?: {
@@ -62,6 +61,7 @@ export declare const createDocumentWithPropertiesParamsSchema: z.ZodObject<{
         category?: string | undefined;
         completed?: boolean | undefined;
     } | undefined;
+    quiet?: boolean | undefined;
 }>;
 export type CreateDocumentWithPropertiesParams = z.infer<typeof createDocumentWithPropertiesParamsSchema>;
 //# sourceMappingURL=params.d.ts.map

package/dist/tools/create_document_with_properties/params.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import { obsidianPropertyOutputSchema } from "../../tools/generate_property/params.js";
+// input properties
+const sourcePath = z
+    .string()
+    .describe('The path to the source markdown file to read and analyze (e.g., "draft/my-article.md")');
+const outputPath = z
+    .string()
+    .optional()
+    .describe("The path where the processed file with properties will be saved. If not provided, the source file will be updated in place.");
+const overwrite = z
+    .boolean()
+    .default(false)
+    .describe("If set to true, existing properties will be overwritten by the AI-generated content. Default: false.");
+const aiGeneratedProperties = obsidianPropertyOutputSchema
+    .optional()
+    .describe("AI-generated properties based on content analysis. If provided, these will be used instead of internal analysis.");
+const quiet = z
+    .boolean()
+    .optional()
+    .default(false)
+    .describe("If true, the final write operation will return a minimal success message.");
+// input schema
+export const createDocumentWithPropertiesParamsSchema = z
+    .object({
+    sourcePath: sourcePath,
+    outputPath: outputPath,
+    overwrite: overwrite.optional(),
+    aiGeneratedProperties: aiGeneratedProperties.optional(),
+    quiet: quiet,
+})
+    .describe("Parameters for creating or updating a document with automatically generated properties");
+//# sourceMappingURL=params.js.map

package/dist/tools/create_document_with_properties/params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.js","sourceRoot":"","sources":["../../../src/tools/create_document_with_properties/params.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAEnF,mBAAmB;AACnB,MAAM,UAAU,GAAG,CAAC;KAClB,MAAM,EAAE;KACR,QAAQ,CACR,wFAAwF,CACxF,CAAC;AACH,MAAM,UAAU,GAAG,CAAC;KAClB,MAAM,EAAE;KACR,QAAQ,EAAE;KACV,QAAQ,CACR,6HAA6H,CAC7H,CAAC;AACH,MAAM,SAAS,GAAG,CAAC;KACjB,OAAO,EAAE;KACT,OAAO,CAAC,KAAK,CAAC;KACd,QAAQ,CACR,sGAAsG,CACtG,CAAC;AACH,MAAM,qBAAqB,GAAG,4BAA4B;KACxD,QAAQ,EAAE;KACV,QAAQ,CACR,kHAAkH,CAClH,CAAC;AACH,MAAM,KAAK,GAAG,CAAC;KACb,OAAO,EAAE;KACT,QAAQ,EAAE;KACV,OAAO,CAAC,KAAK,CAAC;KACd,QAAQ,CACR,2EAA2E,CAC3E,CAAC;AAEH,eAAe;AACf,MAAM,CAAC,MAAM,wCAAwC,GAAG,CAAC;KACvD,MAAM,CAAC;IACP,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE,UAAU;IACtB,SAAS,EAAE,SAAS,CAAC,QAAQ,EAAE;IAC/B,qBAAqB,EAAE,qBAAqB,CAAC,QAAQ,EAAE;IACvD,KAAK,EAAE,KAAK;CACZ,CAAC;KACD,QAAQ,CACR,wFAAwF,CACxF,CAAC"}

package/{build → dist}/tools/generate_property/index.d.ts

@@ -1,6 +1,6 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { CallToolResult, ToolAnnotations } from "@modelcontextprotocol/sdk/types.js";
-import { type ObsidianPropertyQueryParams } from "@/tools/generate_property/params.js";
+import { type ObsidianPropertyQueryParams } from "../../tools/generate_property/params.js";
 export declare const name = "generate_property";
 export declare const annotations: ToolAnnotations;
 export declare const description = "\n  Reads a target markdown document and returns an AI-facing payload for generating frontmatter properties.\n\n  This tool does not write to disk. It returns content_preview and a target output schema so an AI can produce a valid property object.\n\n  Use Cases:\n  - After completing a draft, when you need property suggestions from content.\n  - When missing frontmatter fields (title, tags, summary, slug, date, category, completed) should be generated.\n\n  To apply generated properties to a file, call 'write_property' with the resulting JSON.\n";