Return structuredContent with an outputSchema from status tools
Maintainer antworten meist innerhalb von 1 Tag
Dieses Issue hat noch niemand übernommen.
Bewertung
- Schwierigkeit
- 3/5
- Geschätzter Aufwand
- 1-2 Tage
- Anfängerfreundlichkeit
- 60/100
- Issue-Typ
- Feature
- Klarheit
- Klar beschrieben
- Aktivitätsstatus
- Aktiv
- Tech-Stack
- docker, node.js, typescript
Rechercherichtung
Open mcp-server/src/tools/serviceHealth.ts first — the zod docker-ps schema already exists and is flattened to text around lines 206-233; compare with healthCheck.ts:95-110 and the forNodes helper in mcp-server/src/utils/fan-out.ts:18, which only returns text. Read CLAUDE.md and CONTRIBUTING.md for the registerTool convention, then declare outputSchema per tool and return structuredContent alongside the unchanged text. Run cd mcp-server && npm install && npm test plus npm run typecheck; done means the listed tools validate structured results while text output stays byte-identical.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Beschreibung
Summary
No tool declares outputSchema or returns structuredContent, although several already parse into typed data and then flatten it to text.
Where
mcp-server/src/tools/serviceHealth.ts:206-233mcp-server/src/tools/healthCheck.ts:95-110mcp-server/src/utils/fan-out.ts:18
Details
serviceHealth parses docker ps JSON with a zod schema; healthCheck builds CheckResult[]; forNodes returns only text.
Impact
Clients and agents that chain tools (fleet dashboards, "which nodes have unhealthy containers") must re-parse prose.
Suggested fix
Start with serviceHealth, healthCheck, piStatus, nodeList and backupStatus: declare outputSchema in registerTool and return both the current text and structuredContent. Let forNodes accept a structured per-node result and return { nodes: [{ name, host, ok, data | error }] }.
Open question: keep text output identical for prompts and skills?
Acceptance criteria
- Listed tools return validated structuredContent
- Text output unchanged
Getting started
- Relevant files:
mcp-server/src/tools/serviceHealth.ts,mcp-server/src/tools/healthCheck.ts,mcp-server/src/utils/fan-out.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: enhancement|mcp-server/src/utils/fan-out.ts|structuredContent
- Vorherrschende Sprache
- TypeScript
- Sterne
- 0
- Forks
- 4
- Ø Merge
- 10 Std. 16 Min.
- Gemergte PRs (30 T.)
- 2
Entwicklungsumgebung
- Kein Dockerfile und keine Docker-Compose-Datei
- Hat eine Pull-Request-Vorlage
- Beitragsleitfaden lesen
Erste Schritte
- Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
- Forken Sie das Repository und arbeiten Sie in einem Branch.
- Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.
Mehr aus TMHSDigital/Home-Lab-Developer-Tools
-
speedtestResults ignores count: /api/speedtest/latest returns one resultEvtl. vergeben @laozhej hat das vor 2 Tagen übernommen. Offenbug severity: low
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 80/100
TMHSDigital/Home-Lab-Developer-Tools#160 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Integration tests import tool modules inside tests and can time out under loadEvtl. vergeben @laozhej hat das vor 2 Tagen übernommen. Offengood first issue severity: low testing
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 25/100
TMHSDigital/Home-Lab-Developer-Tools#174 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Grafana dashboard import to complete the export/import round tripEvtl. vergeben @laozhej hat das heute übernommen. Offenenhancement severity: low
Schwierigkeit 3/5 1-2 Tage Anfängerfreundlichkeit 68/100
TMHSDigital/Home-Lab-Developer-Tools#171 ·
Maintainer antworten meist innerhalb von 1 Tag
-
help wanted severity: low testing
Schwierigkeit 4/5 3-5 Tage Anfängerfreundlichkeit 55/100
TMHSDigital/Home-Lab-Developer-Tools#164 · 1 Kommentar ·
Maintainer antworten meist innerhalb von 1 Tag
-
enhancement severity: medium
Schwierigkeit 3/5 1-2 Tage Anfängerfreundlichkeit 72/100
TMHSDigital/Home-Lab-Developer-Tools#159 ·
Maintainer antworten meist innerhalb von 1 Tag
Alle Issues in TMHSDigital/Home-Lab-Developer-Tools
Ähnliche Issues
-
[MCP]: page snapshots in .playwright-mcp/ are not git-ignored (.playwright-cli/ is, since #42318)Offen
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 62/100
microsoft/playwright#44289 ·
Maintainer antworten meist innerhalb von 1 Tag
-
good first issue
Schwierigkeit 2/5 Ein halber Tag Anfängerfreundlichkeit 65/100
Maintainer antworten meist innerhalb von 1 Tag
-
bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 72/100
blamechris/chroxy#9272 ·
Maintainer antworten meist innerhalb von 1 Tag
-
no-repo-link tool-submission
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 66/100
BraveOPotato/NoSignups#2458 ·
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 70/100
drmrd/vernacular#1061 ·
Maintainer antworten meist innerhalb von 1 Tag