Skip to content

Rename filesystem-provider example dir to avoid mcp/ collision#3878

Merged
jlowin merged 1 commit intomainfrom
docs/fix-filesystem-example-dir
Apr 12, 2026
Merged

Rename filesystem-provider example dir to avoid mcp/ collision#3878
jlowin merged 1 commit intomainfrom
docs/fix-filesystem-example-dir

Conversation

@jlowin
Copy link
Copy Markdown
Member

@jlowin jlowin commented Apr 12, 2026

The FileSystemProvider quickstart example tells users to name their components directory mcp/, which collides with the installed mcp SDK package — if a user ever adds __init__.py to that directory, Python's import resolution breaks and FastMCP's own imports start failing with errors like ImportError: cannot import name 'McpError' from 'mcp'. Context: #3812.

Rather than adding a warning about a footgun we ship, this renames the example directory (and all its doc references) to components/. No new guidance needed — the example just stops leading people into the collision.

@marvin-context-protocol marvin-context-protocol Bot added bug Something isn't working. Reports of errors, unexpected behavior, or broken functionality. documentation Updates to docs, examples, or guides. Primary change is documentation-related. labels Apr 12, 2026
@jlowin jlowin merged commit dfe9b30 into main Apr 12, 2026
9 checks passed
@jlowin jlowin deleted the docs/fix-filesystem-example-dir branch April 12, 2026 21:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working. Reports of errors, unexpected behavior, or broken functionality. documentation Updates to docs, examples, or guides. Primary change is documentation-related.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant