@leonardocrdso/obsidian-mcp 1.0.0 → 1.1.0

package/README.md

@@ -7,17 +7,38 @@ Cobertura completa da API com **22 tools** organizadas em 5 módulos.
 ## Requisitos
 
 - [Obsidian](https://obsidian.md/) com o plugin **Local REST API** instalado e ativo
-- [Bun](https://bun.sh/) (desenvolvimento) ou Node.js 18+ (produção)
+- Node.js 18+ ou [Bun](https://bun.sh/)
 
-## Instalação
+## Configuração
+
+### 1. Setup interativo (recomendado)
 
 ```bash
-npm install -g @leonardocrdso/obsidian-mcp
+npx @leonardocrdso/obsidian-mcp --setup
 ```
 
-## Configuração
+```
+  Obsidian MCP — Configuracao
+
+  API Key: sua-api-key-aqui
+  Host [127.0.0.1]: 192.168.1.50
+  Porta [27124]:
+  Protocolo [https]:
+
+  Configuracao salva em ~/.obsidian-mcp.json
+```
+
+O setup pede cada item e salva em `~/.obsidian-mcp.json`. Para reconfigurar, basta rodar `--setup` novamente.
 
-### Variáveis de ambiente
+### 2. Registrar no Claude Code
+
+```bash
+claude mcp add obsidian -- npx @leonardocrdso/obsidian-mcp
+```
+
+### Variáveis de ambiente (alternativa)
+
+Se preferir, configure via variáveis de ambiente em vez do setup interativo:
 
 | Variável | Obrigatória | Padrão | Descrição |
 |---|---|---|---|
@@ -26,8 +47,6 @@ npm install -g @leonardocrdso/obsidian-mcp
 | `OBSIDIAN_PORT` | Não | `27124` | Porta do plugin |
 | `OBSIDIAN_PROTOCOL` | Não | `https` | Protocolo (http ou https) |
 
-### Claude Code (`settings.json`)
-
 ```json
 {
   "mcpServers": {
@@ -42,13 +61,16 @@ npm install -g @leonardocrdso/obsidian-mcp
 }
 ```
 
+Prioridade de configuração: arquivo `~/.obsidian-mcp.json` > variáveis de ambiente.
+
 ### Desenvolvimento
 
 ```bash
 git clone https://github.com/leonardocrdso/obsidian-mcp.git
 cd obsidian-mcp
 bun install
-OBSIDIAN_API_KEY=sua-key bun run dev
+bun run dev --setup  # configurar
+bun run dev          # iniciar servidor
 ```
 
 ## Tools (22)

package/build/index.js

@@ -25,6 +25,7 @@ var __export = (target, all) => {
       set: (newValue) => all[name] = () => newValue
     });
 };
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 
 // node_modules/ajv/dist/compile/codegen/code.js
 var require_code = __commonJS((exports) => {
@@ -6498,6 +6499,116 @@ var require_dist = __commonJS((exports, module) => {
   exports.default = formatsPlugin;
 });
 
+// src/shared/setup.ts
+var exports_setup = {};
+__export(exports_setup, {
+  runSetup: () => runSetup,
+  loadSavedConfig: () => loadSavedConfig
+});
+import { writeFileSync, readFileSync, existsSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+function loadSavedConfig() {
+  if (!existsSync(CONFIG_PATH))
+    return null;
+  try {
+    return JSON.parse(readFileSync(CONFIG_PATH, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function write(text) {
+  process.stderr.write(text);
+}
+function createLineReader() {
+  const lines = [];
+  let waiting = null;
+  let buffer = "";
+  process.stdin.setEncoding("utf-8");
+  process.stdin.on("data", (chunk) => {
+    buffer += chunk;
+    const parts = buffer.split(`
+`);
+    buffer = parts.pop();
+    for (const line of parts) {
+      if (waiting) {
+        const resolve = waiting;
+        waiting = null;
+        resolve(line.trim());
+      } else {
+        lines.push(line.trim());
+      }
+    }
+  });
+  process.stdin.on("end", () => {
+    if (buffer && waiting) {
+      const resolve = waiting;
+      waiting = null;
+      resolve(buffer.trim());
+      buffer = "";
+    }
+  });
+  return (label, fallback) => {
+    const suffix = fallback ? ` [${fallback}]` : "";
+    write(`  ${label}${suffix}: `);
+    if (lines.length > 0) {
+      const value = lines.shift();
+      write(value + `
+`);
+      return Promise.resolve(value || fallback || "");
+    }
+    return new Promise((resolve) => {
+      waiting = (value) => resolve(value || fallback || "");
+    });
+  };
+}
+function mask(value) {
+  if (value.length <= 8)
+    return "*".repeat(value.length);
+  return value.slice(0, 4) + "*".repeat(value.length - 4);
+}
+async function runSetup() {
+  const existing = loadSavedConfig();
+  const prompt = createLineReader();
+  write(`
+  Obsidian MCP — Configuracao
+
+`);
+  const apiKey = await prompt("API Key", existing?.apiKey ? mask(existing.apiKey) : undefined);
+  const host = await prompt("Host", existing?.host ?? "127.0.0.1");
+  const port = await prompt("Porta", existing?.port ?? "27124");
+  const protocol = await prompt("Protocolo", existing?.protocol ?? "https");
+  process.stdin.destroy();
+  if (!apiKey || apiKey.includes("*")) {
+    if (existing?.apiKey && apiKey.includes("*")) {
+      saveConfig({ apiKey: existing.apiKey, host, port, protocol });
+      return;
+    }
+    write(`
+  API Key e obrigatoria.
+
+`);
+    process.exit(1);
+  }
+  saveConfig({ apiKey, host, port, protocol });
+}
+function saveConfig(config2) {
+  writeFileSync(CONFIG_PATH, JSON.stringify(config2, null, 2));
+  write(`
+  Configuracao salva em ${CONFIG_PATH}
+`);
+  write(`
+  Adicione ao Claude Code:
+`);
+  write(`    claude mcp add obsidian -- npx @leonardocrdso/obsidian-mcp
+
+`);
+}
+var CONFIG_PATH;
+var init_setup = __esm(() => {
+  CONFIG_PATH = join(homedir(), ".obsidian-mcp.json");
+});
+
 // node_modules/zod/v3/external.js
 var exports_external = {};
 __export(exports_external, {
@@ -19455,18 +19566,29 @@ class StdioServerTransport {
 }
 
 // src/shared/config.ts
+init_setup();
 function loadConfig() {
+  const saved = loadSavedConfig();
+  if (saved) {
+    const baseUrl = `${saved.protocol}://${saved.host}:${saved.port}`;
+    return { ...saved, baseUrl };
+  }
   const apiKey = process.env.OBSIDIAN_API_KEY;
-  if (!apiKey) {
-    throw new Error("OBSIDIAN_API_KEY não configurada. Defina a variável de ambiente com a API key do plugin Local REST API.");
+  if (apiKey) {
+    const host = process.env.OBSIDIAN_HOST ?? "127.0.0.1";
+    const port = process.env.OBSIDIAN_PORT ?? "27124";
+    const protocol = process.env.OBSIDIAN_PROTOCOL ?? "https";
+    const baseUrl = `${protocol}://${host}:${port}`;
+    return { apiKey, host, port, protocol, baseUrl };
   }
-  const host = process.env.OBSIDIAN_HOST ?? "127.0.0.1";
-  const port = process.env.OBSIDIAN_PORT ?? "27124";
-  const protocol = process.env.OBSIDIAN_PROTOCOL ?? "https";
-  const baseUrl = `${protocol}://${host}:${port}`;
-  return { apiKey, host, port, protocol, baseUrl };
+  throw new Error("Obsidian MCP nao configurado. Execute: npx @leonardocrdso/obsidian-mcp --setup");
+}
+var cached2 = null;
+function getConfig() {
+  if (!cached2)
+    cached2 = loadConfig();
+  return cached2;
 }
-var config2 = loadConfig();
 
 // src/shared/errors.ts
 class ObsidianApiError extends Error {
@@ -19571,7 +19693,14 @@ class ObsidianClient {
 
 // src/modules/vault/vault.tools.ts
 function registerVaultTools(server, client) {
-  server.tool("vaultListFiles", "Lista arquivos e pastas de um diretório do vault. Sem parâmetros lista a raiz.", {
+  server.tool("vaultListFiles", [
+    "Lista arquivos e pastas de um diretório do vault. Sem parâmetros lista a raiz.",
+    "",
+    "IMPORTANTE: Use esta tool ANTES de criar arquivos para entender a estrutura de pastas existente.",
+    "Navegue pela raiz e subpastas para mapear como o vault está organizado por assunto.",
+    "Pastas terminam com '/' no resultado."
+  ].join(`
+`), {
     path: exports_external.string().optional().describe("Caminho do diretório no vault (ex: 'Notes/Projects')")
   }, safeTool(async (params) => {
     const dirPath = params.path ? `${client.encodePath(params.path)}/` : "";
@@ -19596,8 +19725,20 @@ function registerVaultTools(server, client) {
       content: [{ type: "text", text: JSON.stringify(metadata, null, 2) }]
     };
   }));
-  server.tool("vaultCreateFile", "Cria ou substitui um arquivo no vault.", {
-    path: exports_external.string().describe("Caminho do arquivo a criar (ex: 'Notes/novo.md')"),
+  server.tool("vaultCreateFile", [
+    "Cria ou substitui um arquivo no vault.",
+    "",
+    "ANTES de chamar esta tool, você DEVE:",
+    "1. Usar vaultListFiles (sem parâmetros) para ver as pastas raiz do vault.",
+    "2. Explorar as subpastas relevantes para entender a organização por assunto.",
+    "3. Escolher a pasta que melhor se encaixa no tema do arquivo sendo criado.",
+    "4. Se nenhuma pasta existente fizer sentido, crie uma nova seguindo o padrão de nomenclatura já usado no vault.",
+    "",
+    "NUNCA crie arquivos soltos na raiz se houver uma estrutura de pastas organizada.",
+    "O objetivo é manter o vault coerente — cada arquivo deve estar na pasta que melhor representa seu assunto."
+  ].join(`
+`), {
+    path: exports_external.string().describe("Caminho completo do arquivo incluindo a pasta adequada (ex: 'Projetos/meu-projeto/reuniao.md')"),
     content: exports_external.string().describe("Conteúdo do arquivo")
   }, safeTool(async (params) => {
     await client.fetchVoid(`/vault/${client.encodePath(params.path)}`, {
@@ -19609,7 +19750,12 @@ function registerVaultTools(server, client) {
       content: [{ type: "text", text: `Arquivo criado: ${params.path}` }]
     };
   }));
-  server.tool("vaultAppendContent", "Adiciona conteúdo ao final de um arquivo existente no vault.", {
+  server.tool("vaultAppendContent", [
+    "Adiciona conteúdo ao final de um arquivo existente no vault.",
+    "",
+    "Se não souber o path exato do arquivo, use vaultListFiles para navegar pelas pastas e encontrá-lo."
+  ].join(`
+`), {
     path: exports_external.string().describe("Caminho do arquivo no vault"),
     content: exports_external.string().describe("Conteúdo a adicionar ao final")
   }, safeTool(async (params) => {
@@ -19885,10 +20031,16 @@ function registerPeriodicTools(server, client) {
 }
 // src/index.ts
 process.env.NODE_TLS_REJECT_UNAUTHORIZED = "0";
+if (process.argv.includes("--setup")) {
+  const { runSetup: runSetup2 } = await Promise.resolve().then(() => (init_setup(), exports_setup));
+  await runSetup2();
+  process.exit(0);
+}
 var server = new McpServer({
   name: "obsidian-mcp",
   version: "1.0.0"
 });
+var config2 = getConfig();
 var client = new ObsidianClient(config2.baseUrl, config2.apiKey);
 registerVaultTools(server, client);
 registerCommandsTools(server, client);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leonardocrdso/obsidian-mcp",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "MCP server for Obsidian — full Local REST API integration with 22 tools",
   "type": "module",
   "main": "build/index.js",