Return structuredContent with an outputSchema from status tools
維護者通常 1 天內回覆
還沒有人認領這個 Issue。
評估
- 難度
- 3/5
- 預估耗時
- 1-2 天
- 新手友好度
- 60/100
- Issue 類型
- 功能
- 描述清晰度
- 描述清楚
- 活躍度
- 活躍
- 技術堆疊
- docker, node.js, typescript
研究方向
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.
由索引模型根據 Issue 內容生成。
描述
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
- 主要語言
- TypeScript
- 星號
- 0
- 分支
- 4
- 平均合併
- 10 小時 16 分鐘
- 30 天內合併 PR
- 2
環境準備
- 沒有 Dockerfile 或 Docker Compose 檔案
- 有 Pull Request 範本
- 閱讀貢獻指南
從這裡開始
- 先讀完整個 Issue,再讀專案的貢獻指南。
- 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
- Fork 儲存庫,在一個分支上完成修改。
- 送出 Pull Request,並在描述裡引用這個 Issue 編號。
TMHSDigital/Home-Lab-Developer-Tools 的其他 Issue
-
speedtestResults ignores count: /api/speedtest/latest returns one result可能已有人在做 @laozhej 於 2 天前認領。 未關閉bug severity: low
難度 2/5 1-3 小時 新手友好度 80/100
TMHSDigital/Home-Lab-Developer-Tools#160 ·
維護者通常 1 天內回覆
-
Integration tests import tool modules inside tests and can time out under load可能已有人在做 @laozhej 於 2 天前認領。 未關閉good first issue severity: low testing
難度 2/5 1-3 小時 新手友好度 25/100
TMHSDigital/Home-Lab-Developer-Tools#174 ·
維護者通常 1 天內回覆
-
Grafana dashboard import to complete the export/import round trip可能已有人在做 @laozhej 今天認領。 未關閉enhancement severity: low
難度 3/5 1-2 天 新手友好度 68/100
TMHSDigital/Home-Lab-Developer-Tools#171 ·
維護者通常 1 天內回覆
-
help wanted severity: low testing
難度 4/5 3-5 天 新手友好度 55/100
TMHSDigital/Home-Lab-Developer-Tools#164 · 1 則留言 ·
維護者通常 1 天內回覆
-
enhancement severity: medium
難度 3/5 1-2 天 新手友好度 72/100
TMHSDigital/Home-Lab-Developer-Tools#159 ·
維護者通常 1 天內回覆
查看 TMHSDigital/Home-Lab-Developer-Tools 的全部 Issue
相似的 Issue
-
[MCP]: page snapshots in .playwright-mcp/ are not git-ignored (.playwright-cli/ is, since #42318)未關閉
難度 2/5 1-3 小時 新手友好度 62/100
microsoft/playwright#44289 ·
維護者通常 1 天內回覆
-
good first issue
難度 2/5 半天 新手友好度 65/100
維護者通常 1 天內回覆
-
bug
難度 2/5 1-3 小時 新手友好度 72/100
blamechris/chroxy#9272 ·
維護者通常 1 天內回覆
-
no-repo-link tool-submission
難度 1/5 1 小時以內 新手友好度 66/100
BraveOPotato/NoSignups#2458 ·
-
難度 2/5 1-3 小時 新手友好度 70/100
drmrd/vernacular#1061 ·
維護者通常 1 天內回覆