🌐Web Toolkit MCP

Questo toolkit consente a modelli eseguiti in locale di accedere a Internet in modo sicuro, superando i limiti della conoscenza statica e recuperando contenuti aggiornati.

🛠️ Tool disponibili

Il server espone 4 strumenti principali tramite trasporto STDIO:

Related MCP server: mcp-internet

🚀 Requisiti e installazione

1. Prerequisiti: Python 3.10 o superiore e Node.js installati nel sistema.

2. Clona il repository e crea l'ambiente virtuale:

   git clone https://github.com/Dino-996/web_toolkit_mcp.git
   cd web_toolkit_mcp
   python -m venv .venv

3. Attiva l'ambiente virtuale:

   # Windows
   .\.venv\Scripts\activate

   # Linux \ macOS
   source .venv/bin/activate

4. Installa le dipendenze e i browser di Playwright:

   pip install -r requirements.txt
   playwright install chromium

⚙️ Configurazione in LM Studio

Aggiungi il server all'interno del file mcp.json di LM Studio:

Windows

{
  "mcpServers": {
    "web-toolkit": {
      "command": "[percorso_assoluto_progetto]\\.venv\\Scripts\\python.exe",
      "args": [
        "[percorso_assoluto_progetto]\\main.py"
      ]
    }
  }
}

Nota per utenti Windows: Assicurati di sostituire i percorsi con quelli assoluti del tuo sistema, usando il doppio backslash \\ per l'escape.

Linux / macOS

{
  "mcpServers": {
    "web-toolkit": {
      "command": "[percorso_assoluto_progetto]/.venv/bin/python",
      "args": [
        "[percorso_assoluto_progetto]/main.py"
      ]
    }
  }
}

🔒 Sicurezza e protezione

Il codice integra misure di sicurezza native per l'esecuzione sicura in ambienti locali:

• Protezione SSRF Hop-by-Hop: Risoluzione manuale dei redirect per bloccare tentativi di navigazione verso IP privati.

• Mitigazione Prompt Injection: I testi estrapolati dal web vengono racchiusi nei tag [contenuto_non_attendibile], indicando all'LLM di trattarli come dati da analizzare e non come istruzioni da eseguire.

• Isolamento STDIO: Tutti i log di sistema vengono indirizzati su sys.stderr per evitare interferenze con il canale di comunicazione JSON-RPC su stdout.

• Gestione Risorse: Controllo delle istanze concorrenti di Chromium tramite semafori in thread separati per prevenire il saturamento della memoria RAM.

📚 Docs

Documentazione MCP

Specifiche ufficiali del protocollo MCP: https://modelcontextprotocol.io

LM Studio Docs

Guida all'integrazione dei server MCP nell'interfaccia: https://lmstudio.ai/docs