ceos/fastmcp
1
0
Fork 0
mirror of https://github.com/PrefectHQ/fastmcp.git synced 2026-08-22 21:44:18 +02:00
Code Issues Projects Releases Packages Wiki Activity

Simplify disable calls to use keys only; fix filtering docs

Browse source
This commit is contained in:
Jeremiah Lowin 2026-01-18 15:08:39 -05:00
commit 84eb35bcb4
2 changed files with 9 additions and 27 deletions
Download patch file Download diff file Expand all files Collapse all files

11
docs/servers/enabled.mdx
View file

@ -305,14 +305,13 @@ mcp.disable(tags={"maintenance"})
Understanding the filtering logic helps when debugging enabled state issues.
The `is_enabled()` function checks components in this order:
The `is_enabled()` function checks a component's internal metadata:
1. **Blocklist by key**: If the component's key is in `_disabled_keys`, it's disabled
2. **Blocklist by tag**: If any of the component's tags are in `_disabled_tags`, it's disabled
3. **Allowlist check**: If default enabled is off (allowlist mode) and the component isn't in the allowlist, it's disabled
4. **Default**: Otherwise, the component is enabled
1. If the component has `meta.fastmcp._internal.enabled = False`, it's disabled
2. If the component has `meta.fastmcp._internal.enabled = True`, it's enabled
3. If no enabled state is set, the component is enabled by default
The blocklist always wins over the allowlist. A component that matches both is disabled.
When multiple `enable()` and `disable()` calls are made, transforms are applied in order. **Later transforms override earlier ones**, so the last matching transform wins.
## The Enabled Transform

25
src/fastmcp/server/providers/local_provider.py
View file

@ -283,7 +283,7 @@ class LocalProvider(Provider):
tool = Tool.from_function(tool)
self._add_component(tool)
if not enabled:
self.disable(keys={tool.key}, components=["tool"], version=tool.version)
self.disable(keys={tool.key})
return tool
def remove_tool(self, name: str, version: str | None = None) -> None:
@ -374,18 +374,7 @@ class LocalProvider(Provider):
)
self._add_component(resource)
if not enabled:
if isinstance(resource, ResourceTemplate):
self.disable(
keys={resource.key},
components=["template"],
version=resource.version,
)
else:
self.disable(
keys={resource.key},
components=["resource"],
version=resource.version,
)
self.disable(keys={resource.key})
return resource
def remove_resource(self, uri: str, version: str | None = None) -> None:
@ -483,9 +472,7 @@ class LocalProvider(Provider):
)
self._add_component(prompt)
if not enabled:
self.disable(
keys={prompt.key}, components=["prompt"], version=prompt.version
)
self.disable(keys={prompt.key})
return prompt
def remove_prompt(self, name: str, version: str | None = None) -> None:
@ -809,11 +796,7 @@ class LocalProvider(Provider):
)
self._add_component(tool_obj)
if not enabled:
self.disable(
keys={tool_obj.key},
components=["tool"],
version=tool_obj.version,
)
self.disable(keys={tool_obj.key})
return tool_obj
else:
from fastmcp.tools.function_tool import ToolMeta