Terminal Controller MCP-server

Wat doet de “Terminal Controller” MCP-server?

De Terminal Controller MCP-server is een Model Context Protocol (MCP)-server die ontworpen is om veilige uitvoering van terminalopdrachten, navigatie door mappen en bestandsbeheer mogelijk te maken via een gestandaardiseerde interface. Het fungeert als brug tussen AI-assistenten en de hostomgeving, zodat AI-agenten taken kunnen uitvoeren zoals shell-opdrachten uitvoeren, mappen beheren en bestanden programmatisch manipuleren. Dankzij ingebouwde beveiligingen, opdrachtgeschiedenis en platformonafhankelijke compatibiliteit verbetert Terminal Controller ontwikkelingsworkflows door AI-gestuurde tools gecontroleerde toegang te geven tot de terminal en het bestandssysteem van een machine. Hiermee kunnen AI-assistenten op een veilige en gestandaardiseerde manier systeemtaken automatiseren, verkennen en beheren voor ontwikkelaars.

Lijst met prompts

Er zijn geen prompt-templates gevonden in de repository of documentatie.

Lijst met resources

Er zijn geen expliciete MCP-resources gedefinieerd in de repository of documentatie.

Lijst met tools

• Opdrachten uitvoeren: Maakt het mogelijk terminalopdrachten uit te voeren met time-out-controle en legt uitgebreide uitvoer vast.
• Mapbeheer: Stelt je in staat te navigeren door en de inhoud van mappen weer te geven met intuïtieve opmaak.
• Bestandsbewerkingen: Ondersteunt lezen, schrijven, bijwerken, invoegen en verwijderen van bestandsinhoud met precisie op regelniveau.
• Opdrachtgeschiedenis: Houdt recente uitgevoerde opdrachten bij en toont deze voor auditing en herhaalbaarheid.

Gebruikstoepassingen van deze MCP-server

• Geautomatiseerde uitvoering van opdrachten: Ontwikkelaars kunnen AI-assistenten veilig shell-opdrachten laten uitvoeren voor het bouwen, testen of deployen van code, waarbij output en fouten worden vastgelegd.
• Map- en bestandsbeheer: AI-agenten kunnen helpen bij het organiseren, doorzoeken of manipuleren van bestanden en mappen, waardoor automatisering van codebase-verkenning of omgevingsopzet eenvoudiger wordt.
• Beveiligingsbewust scripten: Ingebouwde beveiligingen helpen gevaarlijke opdrachten te voorkomen, waardoor het risico bij het geven van terminaltoegang aan AI wordt verminderd.
• Systeemmonitoring en auditing: De opdrachtgeschiedenis maakt het mogelijk om te volgen welke acties zijn uitgevoerd, wat helpt bij audits en transparantie in workflows.
• Multiplatform ontwikkeling: Door ondersteuning van zowel Windows als UNIX-achtige systemen vergemakkelijkt de MCP-server consistente ontwikkelervaringen in diverse omgevingen.

Hoe stel je het in

Windsurf

1. Zorg dat Python 3.11+ geïnstalleerd is.
2. Installeer het pakket via PyPI:

   pip install terminal-controller
   

3. Bewerk je Windsurf-configuratiebestand om de MCP-server toe te voegen:

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

4. Sla de configuratie op en herstart Windsurf.
5. Controleer of de MCP-server draait en bereikbaar is.

Claude

1. Installeer Python 3.11+ op je computer.
2. Voor Claude Desktop, installeer via Smithery:

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

3. Of installeer via PyPI:

   pip install terminal-controller
   

4. Voeg het volgende toe aan je Claude-configuratie:

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

5. Herstart Claude Desktop en zorg dat de MCP-server wordt gedetecteerd.

Cursor

1. Zorg dat Node.js en Python 3.11+ geïnstalleerd zijn.
2. Installeer terminal-controller:

   pip install terminal-controller
   

3. Voeg de MCP-server toe aan je Cursor-configuratie:

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

4. Sla het bestand op en herstart Cursor.
5. Bevestig de integratie door de lijst met tools in Cursor te controleren.

Cline

1. Zorg dat Python 3.11+ beschikbaar is.
2. Installeer de MCP-server:

   pip install terminal-controller
   

3. Voeg het volgende fragment toe aan je Cline-configuratie:

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

4. Herstart Cline nadat je de wijzigingen hebt opgeslagen.
5. Test door een eenvoudige opdracht via de MCP-interface uit te voeren.

Beveiliging van API-sleutels

Als API-sleutels of geheimen vereist zijn voor jouw setup, gebruik dan omgevingsvariabelen in plaats van deze hard te coderen. Voorbeeldconfiguratie:

{
  "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}"
      }
    }
  }
}

Hoe gebruik je deze MCP binnen flows

MCP gebruiken in FlowHunt

Om MCP-servers te integreren in je FlowHunt-workflow, begin je met het toevoegen van het MCP-component aan je flow en koppel je deze aan je AI-agent:

Klik op het MCP-component om het configuratiepaneel te openen. Voeg in het systeem-MCP-configuratiegedeelte je MCP-servergegevens toe in het volgende JSON-formaat:

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

Zodra dit is ingesteld, kan de AI-agent deze MCP nu als tool gebruiken met toegang tot alle functies en mogelijkheden. Vergeet niet “terminal-controller” te veranderen in de daadwerkelijke naam van jouw MCP-server en de URL aan te passen naar die van jouw eigen MCP-server.

Overzicht

Op basis van het bovenstaande biedt de Terminal Controller MCP essentiële toegang tot terminal en bestandssysteem op een veilige manier, maar mist prompt-templates en expliciete resources. De configuratie is goed gedocumenteerd en platformonafhankelijk. Roots en sampling worden niet genoemd. Al met al is dit een praktische, veilige maar relatief eenvoudige server voor kern-DevOps- of automatiseringsbehoeften.

MCP-score