mirror of
https://github.com/PrefectHQ/fastmcp.git
synced 2026-08-12 00:29:11 +02:00
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
|
|
)
|
|
```
|