HTTP service tools copy the same curl/port/error pattern and have drifted
Los mantenedores suelen responder en 1 día
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 4/5
- Tiempo estimado
- 3-5 días
- Aptitud para principiantes
- 45/100
- Tipo de issue
- Refactorización
- Claridad
- Bien especificado
- Estado de actividad
- Activo
- Stack tecnológico
- typescript
- Área
- tooling
Línea de trabajo
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.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
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
- Lenguaje dominante
- TypeScript
- Estrellas
- 0
- Forks
- 4
- Merge medio
- 10 h 16 min
- PR fusionados (30 d)
- 2
Preparar el entorno
- Sin Dockerfile ni archivo de Docker Compose
- Tiene una plantilla de pull request
- Leer la guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de TMHSDigital/Home-Lab-Developer-Tools
-
speedtestResults ignores count: /api/speedtest/latest returns one resultPosiblemente ocupada @laozhej la tomó hace 2 días. Abiertobug severity: low
Dificultad 2/5 1-3 horas Aptitud para principiantes 80/100
TMHSDigital/Home-Lab-Developer-Tools#160 ·
Los mantenedores suelen responder en 1 día
-
Integration tests import tool modules inside tests and can time out under loadPosiblemente ocupada @laozhej la tomó hace 2 días. Abiertogood first issue severity: low testing
Dificultad 2/5 1-3 horas Aptitud para principiantes 25/100
TMHSDigital/Home-Lab-Developer-Tools#174 ·
Los mantenedores suelen responder en 1 día
-
Grafana dashboard import to complete the export/import round tripPosiblemente ocupada @laozhej la tomó hoy. Abiertoenhancement severity: low
Dificultad 3/5 1-2 días Aptitud para principiantes 68/100
TMHSDigital/Home-Lab-Developer-Tools#171 ·
Los mantenedores suelen responder en 1 día
-
help wanted severity: low testing
Dificultad 4/5 3-5 días Aptitud para principiantes 55/100
TMHSDigital/Home-Lab-Developer-Tools#164 · 1 comentario ·
Los mantenedores suelen responder en 1 día
-
enhancement severity: medium
Dificultad 3/5 1-2 días Aptitud para principiantes 72/100
TMHSDigital/Home-Lab-Developer-Tools#159 ·
Los mantenedores suelen responder en 1 día
Todos los issues de TMHSDigital/Home-Lab-Developer-Tools
Issues similares
-
[MCP]: page snapshots in .playwright-mcp/ are not git-ignored (.playwright-cli/ is, since #42318)Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 62/100
microsoft/playwright#44289 ·
Los mantenedores suelen responder en 1 día
-
good first issue
Dificultad 2/5 Medio día Aptitud para principiantes 65/100
Los mantenedores suelen responder en 1 día
-
bug
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
blamechris/chroxy#9272 ·
Los mantenedores suelen responder en 1 día
-
no-repo-link tool-submission
Dificultad 1/5 Menos de una hora Aptitud para principiantes 66/100
BraveOPotato/NoSignups#2458 ·
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 70/100
drmrd/vernacular#1061 ·
Los mantenedores suelen responder en 1 día