HTTP service tools copy the same curl/port/error pattern and have drifted
Les mainteneurs répondent en général sous 1 jour
Personne n'a encore pris cette issue.
Évaluation
- Difficulté
- 4/5
- Temps estimé
- 3-5 jours
- Accessibilité débutants
- 45/100
- Type d'issue
- Refactorisation
- Clarté
- Clairement spécifiée
- Activité
- Active
- Stack technique
- typescript
- Domaine
- tooling
Piste de recherche
Start in mcp-server/src/utils/service-http.ts to see the existing execSSH, curlErrorResponse and completeJson helpers, then compare mcp-server/src/tools/adguardStats.ts (unguarded) against mcp-server/src/tools/npmCerts.ts (guarded) and certList.ts (duplicated NPM call). Run cd mcp-server && npm install && npm test plus npm run typecheck to get a baseline before changing anything. Done means every HTTP tool routes through the new serviceGet/servicePost/npmGet helpers and each JSON tool applies the truncation guard, with handler tests pinning commands and results for curl exit codes 7, 22 and 28.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
Summary
#103 centralized ports and auth, but about 16 tools still copy the same handler body, and the copies now differ in truncation handling and error text.
Where
mcp-server/src/tools/adguardStats.ts:18-30mcp-server/src/tools/npmCerts.ts:19-31mcp-server/src/tools/certList.ts:44-65mcp-server/src/tools/alertList.ts:39-42mcp-server/src/tools/speedtestResults.ts:33-35mcp-server/src/tools/uptimeKumaStatus.ts:39-50
Details
Pattern: let port = SERVICE.defaultPort; try { port = servicePort(...); const output = await execSSH(curl -sf ...); ... } catch (e) { return curlErrorResponse(e, SERVICE, port) }. The completeJson truncation guard (#117) is used by npmCerts, npmProxyHosts, grafanaSnapshot, adguardQueryLog, prometheusQuery, alertSilences and backupList, but not by adguardStats, adguardFilters, alertList, speedtestResults, uptimeKumaStatus or certList. certList builds its own NPM call and error text, duplicating npmCerts line for line.
Impact
Fixes to HTTP handling have to land in 16 places, and history shows they land in only some. Oversized responses from the six unguarded tools reach the model as cut JSON with no explanation.
Steps to reproduce
- Set
HOMELAB_MAX_OUTPUT_BYTES=100 - Call
homelab_adguardStats: returns a truncated non-JSON fragment; npmCerts returns the explicit truncation error
Suggested fix
- Add
serviceGet(service, node, path, { auth?, json? })andservicePost(...)to service-http.ts: build the curl command, run execSSH, applycompleteJsonwhenjson, map errors withcurlErrorResponse. - Migrate the read-only GET tools one per commit, keeping each tool's formatter.
- Add
npmGet(node, path)and use it in npmCerts, npmProxyHosts and certList.
Before starting: for each migrated tool, a handler test that pins the exact command and the result for curl exit codes 7, 22 and 28 and for truncated output.
Acceptance criteria
- All HTTP tools go through the shared helpers
- Every JSON-returning tool applies the truncation guard
Related: #103, #117
Getting started
- Relevant files:
mcp-server/src/utils/service-http.ts,mcp-server/src/tools/adguardStats.ts,mcp-server/src/tools/certList.ts,mcp-server/src/tools/npmCerts.ts - How to run tests:
cd mcp-server && npm install && npm test(andnpm run typecheck); structure tests:pip install -r requirements-test.txt && pytest tests/ -v - Conventions: see
CLAUDE.mdandCONTRIBUTING.md
Filed by repo-audit/full-audit at 636fefb. Severity: medium. Effort: M. audit-key: tech-debt|mcp-server/src/utils/service-http.ts|curlErrorResponse
- Langage dominant
- TypeScript
- Étoiles
- 0
- Forks
- 4
- Merge moyen
- 10 h 16 min
- PR mergées (30 j)
- 2
Préparer son environnement
- Aucun Dockerfile ni fichier Docker Compose
- Propose un modèle de pull request
- Lire le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de TMHSDigital/Home-Lab-Developer-Tools
-
speedtestResults ignores count: /api/speedtest/latest returns one resultPeut-être pris @laozhej l’a pris il y a 2 jours. Ouvertebug severity: low
Difficulté 2/5 1-3 heures Accessibilité débutants 80/100
TMHSDigital/Home-Lab-Developer-Tools#160 ·
Les mainteneurs répondent en général sous 1 jour
-
Integration tests import tool modules inside tests and can time out under loadPeut-être pris @laozhej l’a pris il y a 2 jours. Ouvertegood first issue severity: low testing
Difficulté 2/5 1-3 heures Accessibilité débutants 25/100
TMHSDigital/Home-Lab-Developer-Tools#174 ·
Les mainteneurs répondent en général sous 1 jour
-
Grafana dashboard import to complete the export/import round tripPeut-être pris @laozhej l’a pris aujourd’hui. Ouverteenhancement severity: low
Difficulté 3/5 1-2 jours Accessibilité débutants 68/100
TMHSDigital/Home-Lab-Developer-Tools#171 ·
Les mainteneurs répondent en général sous 1 jour
-
help wanted severity: low testing
Difficulté 4/5 3-5 jours Accessibilité débutants 55/100
TMHSDigital/Home-Lab-Developer-Tools#164 · 1 commentaire ·
Les mainteneurs répondent en général sous 1 jour
-
enhancement severity: medium
Difficulté 3/5 1-2 jours Accessibilité débutants 72/100
TMHSDigital/Home-Lab-Developer-Tools#159 ·
Les mainteneurs répondent en général sous 1 jour
Toutes les issues de TMHSDigital/Home-Lab-Developer-Tools
Issues similaires
-
[MCP]: page snapshots in .playwright-mcp/ are not git-ignored (.playwright-cli/ is, since #42318)Ouverte
Difficulté 2/5 1-3 heures Accessibilité débutants 62/100
microsoft/playwright#44289 ·
Les mainteneurs répondent en général sous 1 jour
-
good first issue
Difficulté 2/5 Une demi-journée Accessibilité débutants 65/100
Les mainteneurs répondent en général sous 1 jour
-
bug
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
blamechris/chroxy#9272 ·
Les mainteneurs répondent en général sous 1 jour
-
no-repo-link tool-submission
Difficulté 1/5 Moins d'une heure Accessibilité débutants 66/100
BraveOPotato/NoSignups#2458 ·
-
Difficulté 2/5 1-3 heures Accessibilité débutants 70/100
drmrd/vernacular#1061 ·
Les mainteneurs répondent en général sous 1 jour