Component Manager – Contrib Module for FastMCP

The Component Manager provides a unified API for enabling and disabling tools, resources, and prompts at runtime in a FastMCP server. This module is useful for dynamic control over which components are active, enabling advanced features like feature toggling, admin interfaces, or automation workflows.

🔧 Features

Enable/disable tools, resources, and prompts via HTTP endpoints.
Supports local and mounted (server) components.
Customizable API root path.
Optional Auth scopes for secured access.
Fully integrates with FastMCP with minimal configuration.

📦 Installation

This module is part of the fastmcp.contrib package. No separate installation is required if you're already using FastMCP.

🚀 Usage

Basic Setup

python

from fastmcp import FastMCP
from fastmcp.contrib.component_manager import set_up_component_manager

mcp = FastMCP(name="Component Manager", instructions="This is a test server with component manager.")
set_up_component_manager(server=mcp)

🔗 API Endpoints

All endpoints are registered at / by default, or under the custom path if one is provided.

Tools

http

POST /tools/{tool_name}/enable
POST /tools/{tool_name}/disable

Resources

http

POST /resources/{uri:path}/enable
POST /resources/{uri:path}/disable

Supports template URIs as well

http

POST /resources/example://test/{id}/enable
POST /resources/example://test/{id}/disable

Prompts

http

POST /prompts/{prompt_name}/enable
POST /prompts/{prompt_name}/disable

🧪 Example Response

http

HTTP/1.1 200 OK
Content-Type: application/json

{
  "message": "Disabled tool: example_tool"
}

⚙️ Configuration Options

Custom Root Path

To mount the API under a different path:

python

set_up_component_manager(server=mcp, path="/admin")

Securing Endpoints with Auth Scopes

If your server uses authentication:

python

mcp = FastMCP(name="Component Manager", instructions="This is a test server with component manager.", auth=auth)
set_up_component_manager(server=mcp, required_scopes=["write", "read"])

🧪 Example: Enabling a Tool with Curl

bash

curl -X POST \
  -H "Authorization: Bearer YOUR_TOKEN_HERE" \
  -H "Content-Type: application/json" \
  http://localhost:8001/tools/example_tool/enable

🧱 Working with Mounted Servers

You can also combine different configurations when working with mounted servers — for example, using different scopes:

python

mcp = FastMCP(name="Component Manager", instructions="This is a test server with component manager.", auth=auth)
set_up_component_manager(server=mcp, required_scopes=["mcp:write"])

mounted = FastMCP(name="Component Manager", instructions="This is a test server with component manager.", auth=auth)
set_up_component_manager(server=mounted, required_scopes=["mounted:write"])

mcp.mount(server=mounted, namespace="mo")

This allows you to grant different levels of access:

bash

# Accessing the main server gives you control over both local and mounted components
curl -X POST \
  -H "Authorization: Bearer YOUR_TOKEN_HERE" \
  -H "Content-Type: application/json" \
  http://localhost:8001/tools/mo_example_tool/enable

# Accessing the mounted server gives you control only over its own components
curl -X POST \
  -H "Authorization: Bearer YOUR_TOKEN_HERE" \
  -H "Content-Type: application/json" \
  http://localhost:8002/tools/example_tool/enable

⚙️ How It Works

set_up_component_manager() registers HTTP routes for tools, resources, and prompts.
Each endpoint calls server.enable() or server.disable() with the component name.
Returns a success message in JSON.

Maintenance Notice

This module is not officially maintained by the core FastMCP team. It is an independent extension developed by gorocode.

If you encounter any issues or wish to contribute, please feel free to open an issue or submit a pull request, and kindly notify me. I'd love to stay up to date.

📄 License

This module follows the license of the main FastMCP project.