mirror of
https://github.com/PrefectHQ/fastmcp.git
synced 2026-08-09 07:09:11 +02:00
c556f07a66* Archive v3 docs under /v3 and publish v4 as the primary version * Label primary docs version v4.0.0 (alpha 1) * Add What's New in v4 page; fix upgrade-guide phrasing; point banner at What's New * Rewrite What's New around v4's new capabilities, not the sampling deprecation * Lead What's New with the SDK v2 engine swap and the SEPs it brings * State ships now (link Session State); tasks arrive next alpha * Exclude docs/v3 frozen snapshots from doc-example import validation
45 lines
1.1 KiB
Text
45 lines
1.1 KiB
Text
---
|
|
title: Client Roots
|
|
sidebarTitle: Roots
|
|
description: Provide local context and resource boundaries to MCP servers.
|
|
icon: folder-tree
|
|
---
|
|
|
|
import { VersionBadge } from '/snippets/version-badge.mdx'
|
|
|
|
<VersionBadge version="2.0.0" />
|
|
|
|
Use this when you need to tell servers what local resources the client has access to.
|
|
|
|
Roots inform servers about resources the client can provide. Servers can use this information to adjust behavior or provide more relevant responses.
|
|
|
|
## Static Roots
|
|
|
|
Provide a list of roots when creating the client:
|
|
|
|
```python
|
|
from fastmcp import Client
|
|
|
|
client = Client(
|
|
"my_mcp_server.py",
|
|
roots=["/path/to/root1", "/path/to/root2"]
|
|
)
|
|
```
|
|
|
|
## Dynamic Roots
|
|
|
|
Use a callback to compute roots dynamically when the server requests them:
|
|
|
|
```python
|
|
from fastmcp import Client
|
|
from fastmcp.client.roots import RequestContext
|
|
|
|
async def roots_callback(context: RequestContext) -> list[str]:
|
|
print(f"Server requested roots (Request ID: {context.request_id})")
|
|
return ["/path/to/root1", "/path/to/root2"]
|
|
|
|
client = Client(
|
|
"my_mcp_server.py",
|
|
roots=roots_callback
|
|
)
|
|
```
|