Filesystem MCP Server

Co dělá “Filesystem” MCP Server?

Filesystem MCP Server poskytuje bezpečný, programovatelný přístup k místnímu souborovému systému skrze Model Context Protocol (MCP). Umožňuje AI asistentům a dalším klientům pracovat se soubory a adresáři na serveru – včetně čtení, zápisu, kopírování, přesunu, vyhledávání, modifikace souborů i správy adresářů. Server je navržen pro zefektivnění vývojářských workflow, nabízí API pro práci se soubory a přitom důsledně aplikuje bezpečnostní opatření jako povolené adresáře a ověřování cest, aby zabránil neoprávněnému přístupu. Je tak ideálním mostem pro spojení AI agentů s úlohami práce se soubory — podporuje například prozkoumávání kódu, automatizované úpravy souborů, hromadné vyhledávání a nahrazování a mnoho dalšího, vše s detailní kontrolou a robustní bezpečností.

Seznam promptů

V repozitáři nejsou zmíněny žádné explicitní šablony promptů.

Seznam resources

V repozitáři nejsou dokumentovány žádné explicitní MCP “resources”. Server se zaměřuje na zpřístupnění operací se souborovým systémem jako nástrojů.

Seznam nástrojů

• read_file
  Načte celý obsah souboru ze souborového systému.
• read_multiple_files
  Načte obsah více souborů v jedné operaci.
• write_file
  Vytvoří nový soubor nebo přepíše existující novým obsahem.
• copy_file
  Kopíruje soubory a adresáře.
• move_file
  Přesune nebo přejmenuje soubory a adresáře.
• delete_file
  Odstraní soubor nebo adresář ze systému, volitelně rekurzivně.
• modify_file
  Najde a nahradí text v souboru pomocí vyhledávání nebo regexu.
• list_directory
  Vypíše všechny soubory a adresáře v zadané cestě.
• create_directory
  Vytvoří nový adresář nebo ověří existenci adresáře.
• tree
  Vrací hierarchickou JSON reprezentaci struktury adresáře.
• search_files
  Rekurzivně hledá soubory a adresáře odpovídající vzoru.
• search_within_files
  Hledá text uvnitř obsahu souborů napříč stromy adresářů.
• get_file_info
  Získá detailní metadata o souboru nebo adresáři.
• list_allowed_directories
  Vrací seznam adresářů, ke kterým má server povolený přístup.

Příklady použití tohoto MCP serveru

• Automatizované prozkoumávání kódu
  Vývojáři a AI asistenti mohou rychle procházet složky projektů, vypisovat soubory a hledat vzory v kódu nebo typy souborů.
• Hromadná úprava souborů
  Využijte modify_file nástroj pro hromadné nahrazování textu — pomocí prostého textu nebo regexu — napříč více soubory pro efektivní úpravy kódu či textů.
• Bezpečná správa souborů
  Poskytuje kontrolované prostředí pro čtení, zápis, přesun, kopírování či mazání souborů v povolených adresářích, ideální pro automatizaci bez rizika ohrožení celého systému.
• Vyhledávání a objevování obsahu
  Rychle najděte soubory nebo adresáře odpovídající vzoru nebo obsahující specifický obsah, což podporuje dokumentaci, refaktoring či rešerše.
• Automatizované zálohování nebo organizace
  Využijte copy_file, move_file a tree nástroje pro automatizaci záloh, reorganizaci projektu nebo zrcadlení struktury adresářů.

Jak nastavit

Windsurf

1. Ujistěte se, že máte nainstalovaný Go a binární soubor MCP Filesystem Serveru.

2. Otevřete konfigurační soubor Windsurf.

3. Přidejte MCP server s tímto JSON úryvkem:

   {
     "mcpServers": {
       "filesystem": {
         "command": "mcp-filesystem-server",
         "args": ["/path/to/allowed/directory"]
       }
     }
   }
   

4. Uložte konfiguraci a restartujte Windsurf.

5. Ověřte, že “filesystem” MCP server je viditelný ve vašich MCP integracích.

Zabezpečení API klíčů (příklad s proměnnými prostředí)

{
  "mcpServers": {
    "filesystem": {
      "command": "mcp-filesystem-server",
      "args": ["/path/to/allowed/directory"],
      "env": {
        "API_KEY": "${FILESYSTEM_API_KEY}"
      },
      "inputs": {
        "api_key": "${FILESYSTEM_API_KEY}"
      }
    }
  }
}

Claude

1. Stáhněte a nainstalujte Filesystem MCP Server.

2. Najděte konfigurační soubor Claude pro MCP integrace.

3. Vložte registraci serveru takto:

   {
     "mcpServers": {
       "filesystem": {
         "command": "mcp-filesystem-server",
         "args": ["/path/to/allowed/directory"]
       }
     }
   }
   

4. Uložte a restartujte Claude.

5. Zkontrolujte, že Filesystem MCP Server je aktivní.

Cursor

1. Nainstalujte binární soubor serveru pomocí Go nebo stáhněte release.

2. Otevřete nastavení nebo konfigurační soubor Cursoru pro MCP.

3. Přidejte Filesystem MCP Server:

   {
     "mcpServers": {
       "filesystem": {
         "command": "mcp-filesystem-server",
         "args": ["/path/to/allowed/directory"]
       }
     }
   }
   

4. Uložte a restartujte Cursor.

5. Ověřte integraci spuštěním testovacího nástroje (např. list_directory).

Cline

1. Zkompilujte nebo stáhněte binární soubor Filesystem MCP Serveru.

2. Nakonfigurujte MCP integraci v nastavení Cline.

3. Přidejte:

   {
     "mcpServers": {
       "filesystem": {
         "command": "mcp-filesystem-server",
         "args": ["/path/to/allowed/directory"]
       }
     }
   }
   

4. Uložte konfiguraci a restartujte Cline.

5. Otestujte spuštěním operace read_file.

Poznámka ke správě API klíčů

Pro citlivá data používejte proměnné prostředí. Příklad:

{
  "mcpServers": {
    "filesystem": {
      "command": "mcp-filesystem-server",
      "args": ["/path/to/allowed/directory"],
      "env": {
        "API_KEY": "${FILESYSTEM_API_KEY}"
      },
      "inputs": {
        "api_key": "${FILESYSTEM_API_KEY}"
      }
    }
  }
}

Jak MCP využít uvnitř toků

Použití MCP ve FlowHunt

Pro integraci MCP serverů do vašeho FlowHunt workflow začněte přidáním MCP komponenty do vašeho toku a propojte ji s AI agentem:

Klikněte na MCP komponentu a otevřete konfigurační panel. V sekci pro systémovou MCP konfiguraci vložte údaje o vašem MCP serveru pomocí tohoto JSON:

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

Po nastavení má nyní AI agent možnost používat tento MCP jako nástroj se všemi jeho funkcemi. Nezapomeňte změnit “filesystem” dle skutečného názvu vašeho MCP serveru a nahradit URL vlastní URL adresou MCP serveru.

Přehled

| Podpora kořenových adresářů | ✅ | list_allowed_directories zpřístupňuje povolené kořeny |

Náš názor

Filesystem MCP Server je robustní a vysoce zaměřený na bezpečný, detailní přístup k souborovému systému — nabízí širokou sadu operací se soubory a adresáři jako MCP nástroje. Dokumentace je jasná a server poskytuje praktické primitiva pro vývoj workflow poháněných AI. Chybí však dokumentace prompt šablon a explicitních MCP resources, funkce jako sampling nejsou zmíněny. Kořenové adresáře jsou podporovány přes nástroj list_allowed_directories.

Hodnocení: 8/10 — Skvělé nástroje a dokumentace, drobné nedostatky v podporovaných promtech/resources a pokročilých MCP funkcích.

MCP skóre