Skip to content

Conversation

@gaojude
Copy link
Contributor

@gaojude gaojude commented Nov 25, 2025

Users on Windows have been hitting a module resolution error when npx tries to load the MCP server. The error shows up as ERR_MODULE_NOT_FOUND pointing to paths with parentheses like (cache-components) in the directory structure. This happens because npx's cache can get stale or corrupted, particularly on Windows where parentheses in paths can cause module resolution issues.

The fix is simple - clearing the npx cache resolves it - but users had no way to discover this solution on their own. They'd see the cryptic error and have to reach out for support or dig through issues.

This adds a troubleshooting section to the README documenting both this npx cache issue and the "No server info found" error (which happens when users try to use runtime diagnostic tools without a running dev server). The guidance is intentionally concise - just tells users to clear the cache without overwhelming them with platform-specific commands.

Now users can self-serve these common fixes instead of getting stuck during setup.

@gaojude gaojude requested a review from huozhi November 25, 2025 02:05
@gaojude gaojude merged commit 27a80da into main Nov 25, 2025
3 checks passed
@gaojude gaojude deleted the jude/add-troubleshooting-section branch November 25, 2025 02:13
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.

2 participants