MCP-Gas
MCP Server per Google Apps Script - permette a Claude di lavorare autonomamente sui progetti GAS.
Funzionalita
- Gestione Progetti: Lista e naviga i tuoi progetti Google Apps Script
- Lettura/Scrittura Codice: Leggi e modifica i file sorgente (.gs, .html)
- Esecuzione Funzioni: Esegui funzioni direttamente (senza parametri)
- Log Esecuzioni: Visualizza lo storico delle esecuzioni con errori
- Deploy Automatico: Deploy automatico dopo ogni modifica
- Sync GitHub: Sincronizza automaticamente le modifiche su GitHub
Prerequisiti
- Node.js >= 18
- Clasp installato e autenticato:
npm install -g @google/clasp
clasp login- Apps Script API abilitata nel tuo progetto Google Cloud (opzionale, per eseguire funzioni)
Installazione
cd Mcp-Gas
npm install
npm run buildConfigurazione Claude Desktop
Aggiungi al file claude_desktop_config.json:
{
"mcpServers": {
"gas": {
"command": "node",
"args": ["/path/to/Mcp-Gas/dist/index.js"]
}
}
}Tool Disponibili
| Tool | Descrizione |
|---|---|
gas_list_projects | Lista tutti i progetti GAS |
gas_get_project | Dettagli di un progetto specifico |
gas_read_file | Legge un file sorgente |
gas_read_all_files | Legge tutti i file di un progetto |
gas_update_file | Modifica un file (auto-deploy) |
gas_create_file | Crea un nuovo file |
gas_delete_file | Elimina un file |
gas_list_functions | Lista le funzioni disponibili |
gas_run_function | Esegue una funzione |
gas_get_logs | Storico esecuzioni |
gas_list_deployments | Lista i deployment |
gas_deploy | Crea un deployment |
Esempi di Utilizzo
Listare i progetti
Usa gas_list_projects per vedere tutti i miei progetti Apps ScriptLeggere il codice
Leggi tutti i file del progetto con script ID "1abc..."Modificare codice
Nel progetto "1abc...", aggiorna il file "Code" con questa nuova versione:
[codice]Eseguire una funzione
Esegui la funzione "myFunction" nel progetto "1abc..."Vedere i log
Mostrami gli ultimi log di esecuzione del progetto "1abc..."Note Importanti
Per eseguire funzioni:
- Il progetto deve avere un deployment HEAD attivo
- L'Apps Script API deve essere abilitata
- La funzione non deve richiedere parametri
- Per funzioni che richiedono autorizzazioni (Drive, Gmail, ecc.), devi prima eseguirle manualmente una volta per concedere i permessi
Sync GitHub:
Quando usi gas_update_file con il parametro githubRepo, le modifiche vengono automaticamente committate e pushate.
Struttura Progetto
Mcp-Gas/
├── src/
│ ├── index.ts # Entry point MCP server
│ ├── auth/
│ │ └── clasp-auth.ts # Gestione credenziali Clasp
│ ├── tools/
│ │ ├── projects.ts # list_projects, get_project
│ │ ├── code.ts # read/write/create/delete files
│ │ ├── execute.ts # run_function, list_functions
│ │ ├── logs.ts # get_execution_logs
│ │ └── deploy.ts # deploy, list_deployments
│ ├── google-api/
│ │ └── apps-script.ts # Client Apps Script API
│ └── github/
│ └── git-sync.ts # Sincronizzazione GitHub
├── package.json
├── tsconfig.json
└── README.mdLicense
MIT