feat: Add user-level configuration for mcp-hal9002 in VS Code and update workspace setup

2026-03-15 19:52:16 +01:00
parent 335a6e8b95
commit cc410976d2
1 changed files with 45 additions and 2 deletions
@@ -56,9 +56,52 @@ uvx --from git+https://git.enne2.net/enne2/mcp-hal9002.git mcp-hal9002

 ## Uso diretto in VS Code con Copilot

-Il workspace include una configurazione [ .vscode/mcp.json ] che registra `mcp-hal9002` come server MCP `stdio` per GitHub Copilot usando il Python del virtualenv locale e `PYTHONPATH=${workspaceFolder}/src`.
+### Configurazione a livello utente (raccomandata, tramite uvx)

-Nel workspace e presente anche [ .vscode/settings.json ] con `chat.mcp.autostart=true`, cosi VS Code puo riavviare automaticamente il server quando la configurazione cambia.
+Per abilitare `mcp-hal9002` in tutti i workspace VS Code senza dover aprire questo repository, aggiungilo al file di configurazione MCP utente:
+
+**Linux/macOS:** `~/.config/Code/User/mcp.json`  
+**Windows:** `%APPDATA%\Code\User\mcp.json`
+
+Da repository Git (non richiede installazione locale):
+
+```json
+{
+  "servers": {
+    "mcpHal9002": {
+      "type": "stdio",
+      "command": "uvx",
+      "args": [
+        "--from",
+        "git+https://git.enne2.net/enne2/mcp-hal9002.git",
+        "mcp-hal9002"
+      ]
+    }
+  }
+}
+```
+
+Se il pacchetto viene pubblicato su PyPI, la versione semplificata sara:
+
+```json
+{
+  "servers": {
+    "mcpHal9002": {
+      "type": "stdio",
+      "command": "uvx",
+      "args": ["mcp-hal9002"]
+    }
+  }
+}
+```
+
+Dopo aver salvato il file, esegui `MCP: List Servers` in VS Code per rilevare la nuova configurazione, oppure attiva `chat.mcp.autostart` in settings per il riavvio automatico.
+
+### Configurazione di workspace (sviluppo locale)
+
+Il workspace include una configurazione [.vscode/mcp.json](.vscode/mcp.json) che registra `mcp-hal9002` come server MCP `stdio` per GitHub Copilot usando il Python del virtualenv locale e `PYTHONPATH=${workspaceFolder}/src`.
+
+Nel workspace e presente anche [.vscode/settings.json](.vscode/settings.json) con `chat.mcp.autostart=true`, cosi VS Code puo riavviare automaticamente il server quando la configurazione cambia.

 Per usarlo in Copilot: