Implement roadmap configValidate: probe every configured service
Maintainer thường phản hồi trong vòng 1 ngày
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 3/5
- Thời gian dự kiến
- 1-2 ngày
- Mức phù hợp với người mới
- 62/100
- Loại issue
- Tính năng
- Độ rõ ràng
- Đặc tả rõ ràng
- Mức độ hoạt động
- Sôi nổi
- Công nghệ
- node.js, typescript
Hướng nghiên cứu
Read mcp-server/src/utils/service-http.ts first: the SERVICES registry and curlErrorResponse are the pieces the new tool reuses, then look at how mcp-server/src/tools/healthCheck.ts registers and shapes its tool result. Check ROADMAP.md around lines 255-256 for the intended scope, and settle the open question of a separate tool versus folding into healthCheck with the maintainer before writing code. Run cd mcp-server && npm install && npm test and npm run typecheck to see the existing test style. Done means one call returns PASS / FAIL / NOT CONFIGURED per service for a given node or all, with no secret values in the output.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Summary
homelab_configValidate and homelab_configExport are planned in ROADMAP.md but not built; healthCheck only checks that binaries exist.
Where
ROADMAP.md:255-256mcp-server/src/tools/healthCheck.ts:76- mcp-server/src/utils/service-http.ts:19-46 (
SERVICESregistry)
Details
The SERVICES registry already knows each service's name, port variable and default port, and curlErrorResponse already distinguishes auth from connection failures.
Impact
New users discover a wrong port or missing credential one tool at a time (for example AdGuard and Grafana both default to 3000). A single "is my config right" call is the onboarding step the roadmap planned.
Suggested fix
Implement homelab_configValidate: parse HOMELAB_NODES locally, check each key file is readable, then in one SSH round trip per node probe each SERVICES entry with its configured port and credentials, reporting PASS / FAIL / NOT CONFIGURED with the existing hints. Support node: "all". configExport can reuse the same resolution with secret values masked.
Open question: fold into healthCheck or keep a separate tool as the roadmap says?
Acceptance criteria
- One call reports per-service PASS/FAIL/NOT CONFIGURED
- No secret values in output
Getting started
- Relevant files:
mcp-server/src/tools/healthCheck.ts,mcp-server/src/utils/service-http.ts,ROADMAP.md - 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/tools/healthCheck.ts|homelab_configValidate
- Ngôn ngữ chính
- TypeScript
- Star
- 0
- Fork
- 4
- Merge trung bình
- 10 giờ 16 phút
- Pull request đã merge (30 ngày)
- 2
Chuẩn bị môi trường
- Không có Dockerfile hay tệp Docker Compose
- Có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của TMHSDigital/Home-Lab-Developer-Tools
-
speedtestResults ignores count: /api/speedtest/latest returns one resultCó thể đã có người làm @laozhej đã nhận 2 ngày trước. Đang mởbug severity: low
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 80/100
TMHSDigital/Home-Lab-Developer-Tools#160 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Integration tests import tool modules inside tests and can time out under loadCó thể đã có người làm @laozhej đã nhận 2 ngày trước. Đang mởgood first issue severity: low testing
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 25/100
TMHSDigital/Home-Lab-Developer-Tools#174 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Grafana dashboard import to complete the export/import round tripCó thể đã có người làm @laozhej đã nhận hôm nay. Đang mởenhancement severity: low
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 68/100
TMHSDigital/Home-Lab-Developer-Tools#171 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
help wanted severity: low testing
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 55/100
TMHSDigital/Home-Lab-Developer-Tools#164 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
enhancement severity: medium
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 72/100
TMHSDigital/Home-Lab-Developer-Tools#159 ·
Maintainer thường phản hồi trong vòng 1 ngày
Tất cả issue của TMHSDigital/Home-Lab-Developer-Tools
Issue tương tự
-
[MCP]: page snapshots in .playwright-mcp/ are not git-ignored (.playwright-cli/ is, since #42318)Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 62/100
microsoft/playwright#44289 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
good first issue
Độ khó 2/5 Nửa ngày Mức phù hợp với người mới 65/100
Maintainer thường phản hồi trong vòng 1 ngày
-
bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
blamechris/chroxy#9272 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
no-repo-link tool-submission
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 66/100
BraveOPotato/NoSignups#2458 ·
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 70/100
drmrd/vernacular#1061 ·
Maintainer thường phản hồi trong vòng 1 ngày