fastmcp/docs/development
Jeremiah Lowin d779414f8a
Screen templated resource parameters for path traversal by default (#4482)
* Add ResourceSecurity screening for templated resources (defaults on)

* Add tests for resource path-security screening

* Document resource path-security; fix ty in tests

* Carry child template security policy through provider mount

Preserve a mounted template's explicit ResourceSecurity (per-param
exemptions or a deliberate opt-out) through FastMCPProviderResourceTemplate.wrap
so the parent read chokepoint honours it instead of the parent default.

* Defer mcp SDK import so fastmcp.resources loads without the [mcp] extra

* Make resource path-security docs examples self-contained and runnable

* Match exempt_params under both hyphen and underscore spellings

Template placeholders like {git-ref} extract as git_ref, so an exemption
written with the natural URI-template spelling never matched.

* Docs: describe net-depth traversal rule accurately; make example runnable

The screening only rejects .. segments that escape the starting depth
(foo/../bar passes) — saying any standalone .. is rejected overstated
the guarantee. Also define DOCS_ROOT so the example runs.
2026-07-17 17:42:48 -04:00
..
v3-notes Remove deprecated fastmcp.server.apps / server.app shims (3.2) 2026-07-07 07:53:10 -04:00
v4-notes Screen templated resource parameters for path traversal by default (#4482) 2026-07-17 17:42:48 -04:00
contributing.mdx Normalize repo references to PrefectHQ/fastmcp casing (#3218) 2026-02-18 14:51:18 -05:00
releases.mdx Migrate to MCP Python SDK v2 (#4437) 2026-07-06 17:36:45 -04:00
tests.mdx Migrate to MCP Python SDK v2 (#4437) 2026-07-06 17:36:45 -04:00