Thanks for flagging this, but I don't want to add a warning. The real problem is that our own quickstart example tells users to name the directory mcp/:

FileSystemProvider(Path(__file__).parent / "mcp")

That's the footgun — the directory name collides with the installed mcp SDK package, so Python can't resolve component imports correctly. The right fix is to change the example (and the prose reference on the next line) to something neutral like components/ or server/. Once the example isn't leading people into the collision, there's nothing special to warn about. We'd be setting a bad precedent if we started adding cautionary blocks for every package name someone might accidentally shadow — that's what sys.path is for.

Going to close this, but happy to review a follow-up that just updates the example.