Obsidian MCP Server

K čemu slouží “Obsidian” MCP Server?

Obsidian MCP Server je konektor, který umožňuje Claude Desktop – nebo jakémukoliv klientovi Model Context Protocol (MCP) – číst a vyhledávat složky obsahující poznámky ve formátu Markdown, například v trezoru Obsidian. Tento server přemosťuje propast mezi AI asistenty a vašimi osobními či týmovými znalostními bázemi uloženými v Markdownu, což usnadňuje přístup, vyhledávání a využívání poznámek ve vývojových workflow. Díky integraci s externími zdroji dat, jako je Obsidian, server umožňuje AI nástrojům provádět úlohy jako vyhledávání informací, získávání konkrétních poznámek či shrnutí obsahu, a tím zvyšuje produktivitu a správu znalostí pro vývojáře i pracovníky s informacemi.

Seznam promptů

V dostupné dokumentaci nebyly explicitně uvedeny žádné šablony promptů.

Seznam zdrojů

V poskytnuté dokumentaci nejsou uvedeny žádné konkrétní zdroje.

Seznam nástrojů

Z dokumentace a dostupných obrázků jsou po instalaci k dispozici (byť v kódu nejsou blíže popsány) následující nástroje:

• Read Note: Umožňuje přečíst obsah konkrétní poznámky v trezoru Obsidian.
• Search Notes: Umožňuje vyhledávat poznámky v trezoru na základě klíčových slov nebo dotazů.

Poznámka: Přesné názvy a popisy nástrojů jsou odvozeny z dostupné dokumentace a obrázků; podrobnější informace nejsou specifikovány.

Příklady využití tohoto MCP Serveru

• Osobní správa znalostí: Pohodlně vyhledávejte, čtěte a získávejte informace z osobních trezorů Obsidian pomocí Claude Desktop, čímž zpřístupníte své poznámky LLM pro sumarizaci či odpovídání na dotazy.
• Vyhledávání v týmové dokumentaci: Integrujte sdílené Markdown složky jako prohledávatelné zdroje pro členy týmu nebo AI asistenty a zlepšete sdílení znalostí i onboarding.
• Kontextová AI asistence: Poskytujte relevantní informace z vašich poznámek jako kontext pro LLM, čímž zvýšíte relevanci a přesnost AI generovaných odpovědí během vývoje nebo výzkumu.
• Automatizované shrnování poznámek: Využijte AI ke shrnutí dlouhých poznámek či dokumentů v trezoru Obsidian a ušetřete čas oproti ručnímu shrnování.

Jak nastavit

Windsurf

1. Ujistěte se, že máte nainstalované Node.js a Windsurf.
2. Otevřete svůj konfigurační soubor Windsurf.
3. Přidejte následující do sekce mcpServers:

   {
     "obsidian": {
       "command": "npx",
       "args": ["-y", "mcp-obsidian", "<path-to-your-vault>"]
     }
   }
   

4. Uložte soubor a restartujte Windsurf.
5. Ověřte, že MCP server běží a je dostupný.

Claude

1. Ujistěte se, že máte nainstalovaný Claude Desktop a Node.js.
2. Nainstalujte Obsidian MCP pomocí Smithery:

   npx @smithery/cli install mcp-obsidian --client claude
   

3. Restartujte Claude Desktop.
4. Ověřte, že se nástroje Obsidian MCP objeví v rozhraní Claude Desktop.

Cursor

1. Ujistěte se, že máte nainstalované Node.js a Cursor.
2. Otevřete svůj konfigurační soubor Cursor.
3. Přidejte Obsidian MCP server takto:

   {
     "obsidian": {
       "command": "npx",
       "args": ["-y", "mcp-obsidian", "<path-to-your-vault>"]
     }
   }
   

4. Uložte a restartujte Cursor.
5. Zkontrolujte v seznamu nástrojů Cursor, zda je Obsidian MCP server dostupný.

Cline

1. Nainstalujte Node.js a Cline.
2. Upravte svůj konfigurační soubor Cline.
3. Přidejte Obsidian MCP server:

   {
     "obsidian": {
       "command": "npx",
       "args": ["-y", "mcp-obsidian", "<path-to-your-vault>"]
     }
   }
   

4. Uložte konfiguraci a restartujte Cline.
5. Ověřte nastavení tím, že zkontrolujete přítomnost Obsidian MCP v rozhraní.

Zabezpečení API klíčů

Pokud Obsidian MCP server nebo váš trezor vyžaduje autentizaci či API klíče, použijte pro bezpečnost environmentální proměnné:

{
  "obsidian": {
    "command": "npx",
    "args": ["-y", "mcp-obsidian", "<path-to-your-vault>"],
    "env": {
      "OBSIDIAN_API_KEY": "${env:OBSIDIAN_API_KEY}"
    },
    "inputs": {
      "vaultPath": "<path-to-your-vault>"
    }
  }
}

Jak použít tento MCP ve flow

Použití MCP ve FlowHunt

Pro integraci MCP serverů do vašeho workflow ve FlowHunt nejprve přidejte MCP komponentu do vašeho flow a propojte ji s AI agentem:

Klikněte na MCP komponentu pro otevření konfiguračního panelu. V sekci systémové konfigurace MCP vložte detaily vašeho MCP serveru v tomto JSON formátu:

{
  "obsidian": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Po nastavení je AI agent schopen využívat tento MCP jako nástroj se všemi jeho funkcemi a možnostmi. Nezapomeňte změnit “obsidian” na skutečný název vašeho MCP serveru a nahradit URL adresou vašeho MCP serveru.

Přehled

Na základě výše uvedeného je Obsidian MCP Server přímočarý a snadno nastavitelný pro vyhledávání a získávání poznámek z Obsidian trezoru, ale postrádá detailní šablony promptů, explicitní definici zdrojů a pokročilé MCP funkce jako sampling nebo roots. Přesto poskytuje základní nástroje pro zpřístupnění poznámek z Obsidianu pro AI.

MCP skóre

Díky jednoduchosti a srozumitelnosti účelu, snadné instalaci a specifickému užitku pro uživatele Obsidian bych tento MCP server ohodnotil na 6/10. Je velmi vhodný pro svůj účel, ale postrádá pokročilé MCP funkce i rozsáhlejší dokumentaci pro širší rozšiřitelnost.