HTTP service tools copy the same curl/port/error pattern and have drifted
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ó
- 4/5
- Thời gian dự kiến
- 3-5 ngày
- Mức phù hợp với người mới
- 45/100
- Loại issue
- Tái cấu trúc
- Độ rõ ràng
- Đặc tả rõ ràng
- Mức độ hoạt động
- Sôi nổi
- Công nghệ
- typescript
- Lĩnh vực
- tooling
Hướng nghiên cứu
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.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
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
- 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