Skip to content

Improve error messages for common dev server issues#27

Merged
abewheel merged 1 commit intomainfrom
abewheel/https-parse-error
Mar 29, 2026
Merged

Improve error messages for common dev server issues#27
abewheel merged 1 commit intomainfrom
abewheel/https-parse-error

Conversation

@abewheel
Copy link
Copy Markdown
Contributor

Summary

  • Detect TLS ClientHello packets in clientError handlers across all three HTTP servers (MCP dev, production, sandbox) and log a clear message pointing to ngrok HTTPS misconfiguration instead of dumping raw bytes.
  • Add actionable connection error messages in the inspector: 404 suggests checking the URL, 5xx points to server logs, network failures say the server isn't reachable.
  • Include file paths and expected export signatures in tool extraction/loading warnings during sunpeak dev.
  • Show which port was in use when the server falls back to another port.
  • Include resource name in build-not-found errors.
  • Regenerated examples pick up version bumps from recent dependency upgrades.

Test plan

  • pnpm validate passes (lint, typecheck, build, 247 unit tests, 22 e2e tests, docs, all examples, production server, inspect mode, dev server)

Add actionable error messages for HTTPS-on-HTTP misconfigurations (TLS
ClientHello detection), connection failures with status-specific guidance,
tool extraction warnings with file paths, port conflict fallback messaging,
and resource build-not-found errors with resource names.
@abewheel abewheel merged commit 364474e into main Mar 29, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant