Terminal Controller MCP Server

Ce face serverul MCP „Terminal Controller”?

Terminal Controller MCP Server este un server Model Context Protocol (MCP) creat pentru a permite execuția securizată a comenzilor din terminal, navigarea prin directoare și operațiuni pe sistemul de fișiere printr-o interfață standardizată. Acționează ca o punte între asistenții AI și mediul gazdă, permițând agenților AI să ruleze comenzi shell, să gestioneze directoare și să manipuleze fișiere programatic. Cu protecții de securitate integrate, urmărirea istoriei comenzilor și compatibilitate multiplatformă, Terminal Controller îmbunătățește fluxurile de dezvoltare oferind instrumentelor AI acces controlat la terminalul și sistemul de fișiere al unei mașini. Această capacitate oferă asistenților AI posibilitatea de a automatiza, explora și gestiona sarcini la nivel de sistem pentru dezvoltatori într-un mod sigur și standardizat.

Lista de template-uri de prompt

Nu au fost găsite template-uri de prompt în depozit sau documentație.

Lista de resurse

Nu au fost definite resurse MCP explicite în depozit sau documentație.

Lista de unelte

• Execuție comenzi: Permite rularea comenzilor de terminal cu control asupra timeout-ului și capturarea completă a ieșirii.
• Gestionare directoare: Permite navigarea și listarea conținutului directoarelor cu formatare intuitivă.
• Operațiuni pe fișiere: Suportă citirea, scrierea, actualizarea, inserarea și ștergerea conținutului fișierelor cu precizie la nivel de linie.
• Istoric comenzi: Urmărește și afișează execuțiile recente ale comenzilor pentru audit și repetabilitate.

Cazuri de utilizare pentru acest MCP Server

• Execuție automată a comenzilor: Dezvoltatorii pot instrui asistenții AI să ruleze în siguranță comenzi shell pentru build, testare sau deployment, cu capturarea ieșirii și erorilor.
• Gestionarea directoarelor și fișierelor: Agenții AI pot ajuta la organizarea, navigarea sau manipularea fișierelor și folderelor, facilitând automatizarea explorării codului sau configurării mediului.
• Scripting cu accent pe securitate: Protecțiile integrate ajută la prevenirea comenzilor periculoase, reducând riscul oferirii accesului la terminal AI-ului.
• Monitorizare și auditare sistem: Funcțiile de istoric comenzi permit urmărirea acțiunilor efectuate, ajutând la audit și la transparența fluxului de lucru.
• Dezvoltare multi-platformă: Suportând atât Windows cât și sisteme UNIX, serverul MCP facilitează experiențe de dezvoltare consistente pe medii diverse.

Cum se instalează

Windsurf

1. Asigură-te că ai instalat Python 3.11+.
2. Instalează pachetul prin PyPI:

   pip install terminal-controller
   

3. Editează fișierul de configurare Windsurf pentru a adăuga serverul MCP:

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

4. Salvează configurația și repornește Windsurf.
5. Verifică dacă serverul MCP rulează și este accesibil.

Claude

1. Instalează Python 3.11+ pe sistemul tău.
2. Pentru Claude Desktop, instalează via Smithery:

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

3. Alternativ, instalează prin PyPI:

   pip install terminal-controller
   

4. Adaugă următoarea secțiune în configurația Claude:

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

5. Repornește Claude Desktop și asigură-te că serverul MCP este detectat.

Cursor

1. Asigură-te că ai instalat Node.js și Python 3.11+.
2. Instalează terminal-controller:

   pip install terminal-controller
   

3. Adaugă serverul MCP în configurația Cursor:

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

4. Salvează fișierul și repornește Cursor.
5. Confirmă integrarea verificând lista de unelte din Cursor.

Cline

1. Asigură-te că Python 3.11+ este disponibil.
2. Instalează serverul MCP:

   pip install terminal-controller
   

3. Adaugă următorul fragment în configurația Cline:

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

4. Repornește Cline după salvarea modificărilor.
5. Testează rulând o comandă simplă prin interfața MCP.

Securizarea cheilor API

Dacă ai nevoie de chei API sau secrete pentru configurare, folosește variabile de mediu în loc să le inserezi direct în cod. Exemplu de configurație:

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

Cum folosești acest MCP în fluxuri

Utilizarea MCP în FlowHunt

Pentru a integra serverele MCP în fluxul tău FlowHunt, începe prin a adăuga componenta MCP în flux și a o conecta la agentul tău AI:

Fă click pe componenta MCP pentru a deschide panoul de configurare. În secțiunea de configurare a sistemului MCP, inserează detaliile serverului tău MCP folosind acest format JSON:

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

După configurare, agentul AI va putea folosi acest MCP ca unealtă, având acces la toate funcțiile și capabilitățile sale. Nu uita să schimbi “terminal-controller” cu numele real al serverului tău MCP și să înlocuiești URL-ul cu adresa serverului tău MCP.

Prezentare generală

Pe baza celor de mai sus, Terminal Controller MCP oferă acces esențial și sigur la terminal și sistemul de fișiere, dar nu include template-uri de prompt sau resurse explicite. Configurarea sa este bine documentată și multi-platformă. Nu sunt menționate rădăcini sau sampling. În ansamblu, este un server practic, sigur, dar relativ simplu pentru nevoi de bază DevOps sau automatizare.

Scor MCP