Terminálový kontrolér MCP Server

Čo robí “Terminálový kontrolér” MCP Server?

Terminálový kontrolér MCP Server je server typu Model Context Protocol (MCP) navrhnutý na bezpečné vykonávanie príkazov v termináli, navigáciu v adresároch a operácie so súborovým systémom cez štandardizované rozhranie. Pôsobí ako most medzi AI asistentmi a hostiteľským prostredím, čo AI agentom umožňuje vykonávať úlohy ako spúšťanie shell príkazov, správu adresárov a programovateľnú manipuláciu so súbormi. S integrovanými bezpečnostnými ochranami, sledovaním histórie príkazov a multiplatformovou kompatibilitou zvyšuje Terminálový kontrolér efektivitu vývoja tým, že AI nástrojom poskytuje kontrolovaný prístup k terminálu a súborovému systému stroja. Táto schopnosť dáva AI asistentom možnosť automatizovať, skúmať a spravovať systémové úlohy pre vývojárov bezpečne a štandardizovane.

Zoznam promptov

V repozitári ani v dokumentácii sa nenašli žiadne šablóny promptov.

Zoznam zdrojov

V repozitári ani v dokumentácii neboli definované žiadne explicitné MCP zdroje.

Zoznam nástrojov

• Vykonávanie príkazov: Umožňuje spúšťať terminálové príkazy s kontrolou timeoutu a zachytávať kompletný výstup.
• Správa adresárov: Umožňuje navigáciu a výpis obsahu adresárov s intuitívnym formátovaním.
• Operácie so súbormi: Podporuje čítanie, zápis, úpravu, vkladanie a mazanie obsahu súborov s presnosťou na úrovni riadkov.
• História príkazov: Sledovanie a zobrazenie posledných vykonaných príkazov pre audit a opakovateľnosť.

Príklady použitia tohto MCP Servera

• Automatizované vykonávanie príkazov: Vývojári môžu inštruovať AI asistentov, aby bezpečne spúšťali shell príkazy na zostavovanie, testovanie alebo nasadzovanie kódu, s výstupom a chybami zaznamenanými.
• Správa adresárov a súborov: AI agenti môžu pomôcť organizovať, prehliadať alebo manipulovať so súbormi a zložkami, čo zjednodušuje automatizáciu prehliadania kódu alebo prípravu prostredia.
• Bezpečnostne uvedomelé skriptovanie: Zabudované ochrany pomáhajú predchádzať nebezpečným príkazom a znižujú riziko pri poskytovaní AI prístupu do terminálu.
• Monitorovanie systému a audit: Funkcie histórie príkazov umožňujú sledovať vykonané akcie, čo pomáha pri auditoch a transparentnosti pracovného postupu.
• Multiplatformový vývoj: Podpora Windows aj UNIX systémov umožňuje konzistentný vývoj naprieč rôznymi prostrediami.

Ako to nastaviť

Windsurf

1. Uistite sa, že máte nainštalovaný Python 3.11+.
2. Balík nainštalujte cez PyPI:

   pip install terminal-controller
   

3. Upravte konfiguračný súbor Windsurf a pridajte MCP server:

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

4. Uložte konfiguráciu a reštartujte Windsurf.
5. Overte, že MCP server beží a je prístupný.

Claude

1. Na svojom zariadení nainštalujte Python 3.11+.
2. Pre Claude Desktop inštalujte cez Smithery:

   npx -y @smithery/cli install @GongRzhe/terminal-controller-mcp --client claude
   

3. Alternatívne inštalujte cez PyPI:

   pip install terminal-controller
   

4. Pridajte nasledovné do Claude konfigurácie:

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

5. Reštartujte Claude Desktop a uistite sa, že MCP server je rozpoznaný.

Cursor

1. Uistite sa, že máte nainštalovaný Node.js a Python 3.11+.
2. Nainštalujte terminal-controller:

   pip install terminal-controller
   

3. Pridajte MCP server do konfigurácie Cursor:

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

4. Uložte súbor a reštartujte Cursor.
5. Overte integráciu skontrolovaním zoznamu nástrojov v Cursor.

Cline

1. Uistite sa, že je dostupný Python 3.11+.
2. Nainštalujte MCP server:

   pip install terminal-controller
   

3. Pridajte nasledovný úryvok do konfigurácie Cline:

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

4. Po uložení zmien reštartujte Cline.
5. Otestujte MCP rozhranie spustením jednoduchého príkazu.

Zabezpečenie API kľúčov

Ak vaše nastavenie vyžaduje API kľúče alebo tajomstvá, použite environmentálne premenné namiesto ich pevného zápisu. Príklad konfigurácie:

{
  "mcpServers": {
    "terminal-controller": {
      "command": "python",
      "args": ["-m", "terminal_controller"],
      "env": {
        "MY_API_KEY": "${MY_API_KEY_ENV_VAR}"
      },
      "inputs": {
        "api_key": "${MY_API_KEY_ENV_VAR}"
      }
    }
  }
}

Ako používať tento MCP vo flowoch

Použitie MCP vo FlowHunt

Pre integráciu MCP serverov do vášho FlowHunt pracovného postupu začnite pridaním MCP komponentu do flowu a jeho prepojením s AI agentom:

Kliknite na MCP komponent pre otvorenie konfiguračného panela. V sekcii systémovej MCP konfigurácie zadajte údaje o vašom MCP serveri v tomto JSON formáte:

{
  "terminal-controller": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Po nakonfigurovaní je AI agent schopný používať tento MCP ako nástroj s prístupom ku všetkým jeho funkciám a možnostiam. Nezabudnite zmeniť “terminal-controller” na skutočný názov vášho MCP servera a URL na vašu vlastnú adresu MCP servera.

Prehľad

Na základe vyššie uvedeného Terminálový kontrolér MCP ponúka základný prístup k terminálu a súborovému systému bezpečným spôsobom, ale chýbajú mu šablóny promptov a explicitné zdroje. Jeho konfigurácia je dobre zdokumentovaná a je multiplatformová. Roots a sampling nie sú spomenuté. Celkovo ide o praktický, bezpečný, ale pomerne jednoduchý server pre základné DevOps alebo automatizačné potreby.

MCP Skóre