MCP Server per assistere lo sviluppo di personalizzazioni (MCP Server to assist development of customizations)
Server has 7 tools with explicit @Tool annotations and descriptions. All tools are READ_ONLY and well-intentioned for ERP documentation and GitHub exploration. However, critical gaps exist: (1) Input schemas are visible but lack formal type constraints (enums, ranges, patterns). (2) Descriptions are verbose (200-400 chars) but include example values that LLMs may reuse literally (e.g., 'vendite', 'magazzino', 'spring-projects'). (3) No output schemas documented, LLMs cannot predict response structure for chaining. (4) Parameter descriptions exist but lack format/constraint details (e.g., maxCount accepts 1-30 but this is buried in prose, not a schema constraint). (5) No error handling guidance, tools return strings with no recovery hints. (6) searchRepoCode and getFileContent note GitHub rate limits but offer no fallback or retry strategy.
Mostra i dettagli e il diff di un commit specifico di una repository GitHub pubblica. Usare quando lo sviluppatore chiede: - Quali file sono stati modificati in un certo commit - Come è stata implementata una feature specifica (vedere le modifiche) - Esempi concreti di come un progetto open source ha risolto un problema Parametri: owner, repo, sha (SHA del commit, anche abbreviato a 7 caratteri). Restituisce: messaggio completo, lista dei file modificati con patch diff (max 100 righe per file). Ottieni i SHA dalla funzione getRecentCommits.
Legge il contenuto di un file specifico in una repository GitHub pubblica. Usare quando lo sviluppatore chiede: - Di vedere il codice di una classe/file specifico in un progetto di riferimento - Di leggere la configurazione di un progetto open source - Di analizzare come è strutturato un file in una codebase reale Parametri: owner, repo, filePath (percorso relativo nella repo), ref (branch/SHA, opzionale). Restituisce: contenuto testuale del file (max 300 righe, poi troncato). Esempio filePath: 'src/main/java/org/springframework/boot/SpringApplication.java' Ottieni i path dei file tramite searchRepoCode o da URL GitHub.
Recupera i commit recenti di una repository GitHub pubblica. Usare quando lo sviluppatore chiede: - Cosa è cambiato di recente in un progetto di riferimento - La storia dei cambiamenti di una libreria/framework - Esempi di commit message per ispirarsi Parametri: owner, repo, branch (opzionale), maxCount (1-30, default 10). Restituisce: lista di commit con SHA, data, autore e prima riga del messaggio. Usa getCommitDiff per vedere i dettagli di un commit specifico.
No output schemas documented. LLMs cannot predict response structure (fields, types, pagination). Breaks tool chaining and forces LLMs to guess what data is available.
Example values embedded in descriptions ('vendite', 'magazzino', 'spring-projects', 'main', 'master'). LLMs reuse examples literally instead of adapting to context, causing failed API calls.
Input schemas lack formal constraints. maxCount (1-30) is prose-only; no JSON Schema minValue/maxValue. module parameter accepts any string; no enum of valid modules. LLMs cannot validate before calling.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 50 | 2026-07-28+ | v2 |
Recupera le informazioni generali di una repository GitHub pubblica. Usare quando lo sviluppatore chiede: - Informazioni su un progetto open source di riferimento - Quale linguaggio usa una certa libreria/framework - Dettagli generali prima di esplorare il codice Parametri: owner (es. 'spring-projects') e repo (es. 'spring-framework'). Restituisce: descrizione, linguaggi, stars, forks, branch default, data ultimo push.
Legge la documentazione del framework ERP per un modulo specifico. Usare quando lo sviluppatore chiede: - Come funziona una parte del gestionale - Come si fa un tipo di personalizzazione - Quali sono le convenzioni da seguire in un modulo Parametro 'module': nome del modulo, es. 'vendite', 'magazzino', 'contabilita'. Passare 'index' per ottenere la lista di tutti i moduli disponibili. NON usare per cercare esempi di codice specifici: usare searchDocs invece.
Cerca una keyword o concetto in tutta la documentazione del framework ERP. Usare quando lo sviluppatore chiede: - Come si fa una cosa specifica senza sapere in quale modulo si trova - Se esiste documentazione su un argomento - Tutte le occorrenze di un concetto nella documentazione Parametro 'query': parola chiave o frase da cercare. Es: 'campo custom', 'override', 'validazione', 'trigger db'. Restituisce i paragrafi rilevanti con il nome del file di provenienza.
Cerca una keyword o pattern nel codice sorgente di una repository GitHub pubblica. Usare quando lo sviluppatore chiede: - Esempi di utilizzo di una certa API, annotazione o pattern in un progetto reale - Come viene usata una specifica classe/metodo in un codebase open source - Se un certo pattern esiste nella codebase di riferimento Parametri: owner, repo, query (keyword o frase). Restituisce: lista di file che contengono la keyword con il loro path e URL. Usa getFileContent per leggere il contenuto di un file trovato. NOTA: richiede un github.token configurato per funzionare in modo affidabile (l'API di ricerca GitHub ha un rate limit molto basso per richieste non autenticate).
No error handling guidance. Tools return plain strings with no recovery hints. If GitHub API rate-limits or a module is not found, LLM has no actionable next step.
searchRepoCode and getFileContent mention GitHub rate limits and token requirement but provide no fallback, retry logic, or clear error message. Agents will fail silently on rate-limit 403.