manager

Prompt management functionality.

PromptManager

Manages MCPServer prompts.

Source code in src/mcp/server/mcpserver/prompts/manager.py

class PromptManager:
    """Manages MCPServer prompts."""

    def __init__(self, warn_on_duplicate_prompts: bool = True):
        self._prompts: dict[str, Prompt] = {}
        self.warn_on_duplicate_prompts = warn_on_duplicate_prompts

    def get_prompt(self, name: str) -> Prompt | None:
        """Get prompt by name."""
        return self._prompts.get(name)

    def list_prompts(self) -> list[Prompt]:
        """List all registered prompts."""
        return list(self._prompts.values())

    def add_prompt(
        self,
        prompt: Prompt,
    ) -> Prompt:
        """Add a prompt to the manager."""

        # Check for duplicates
        existing = self._prompts.get(prompt.name)
        if existing:
            if self.warn_on_duplicate_prompts:
                logger.warning(f"Prompt already exists: {prompt.name}")
            return existing

        self._prompts[prompt.name] = prompt
        return prompt

    def remove_prompt(self, name: str) -> None:
        """Remove a prompt by name."""
        if name not in self._prompts:
            raise ValueError(f"Unknown prompt: {name}")
        del self._prompts[name]

    async def render_prompt(
        self,
        name: str,
        arguments: dict[str, Any] | None,
        context: Context[LifespanContextT, RequestT],
    ) -> list[Message] | InputRequiredResult:
        """Render a prompt by name with arguments."""
        prompt = self.get_prompt(name)
        if not prompt:
            raise ValueError(f"Unknown prompt: {name}")

        return await prompt.render(arguments, context)

get_prompt

get_prompt(name: str) -> Prompt | None

Get prompt by name.

Source code in src/mcp/server/mcpserver/prompts/manager.py

def get_prompt(self, name: str) -> Prompt | None:
    """Get prompt by name."""
    return self._prompts.get(name)

list_prompts

list_prompts() -> list[Prompt]

List all registered prompts.

Source code in src/mcp/server/mcpserver/prompts/manager.py

def list_prompts(self) -> list[Prompt]:
    """List all registered prompts."""
    return list(self._prompts.values())

add_prompt

add_prompt(prompt: Prompt) -> Prompt

Add a prompt to the manager.

Source code in src/mcp/server/mcpserver/prompts/manager.py

def add_prompt(
    self,
    prompt: Prompt,
) -> Prompt:
    """Add a prompt to the manager."""

    # Check for duplicates
    existing = self._prompts.get(prompt.name)
    if existing:
        if self.warn_on_duplicate_prompts:
            logger.warning(f"Prompt already exists: {prompt.name}")
        return existing

    self._prompts[prompt.name] = prompt
    return prompt

remove_prompt

remove_prompt(name: str) -> None

Remove a prompt by name.

Source code in src/mcp/server/mcpserver/prompts/manager.py

def remove_prompt(self, name: str) -> None:
    """Remove a prompt by name."""
    if name not in self._prompts:
        raise ValueError(f"Unknown prompt: {name}")
    del self._prompts[name]

render_prompt async

render_prompt(
    name: str,
    arguments: dict[str, Any] | None,
    context: Context[LifespanContextT, RequestT],
) -> list[Message] | InputRequiredResult

Render a prompt by name with arguments.

Source code in src/mcp/server/mcpserver/prompts/manager.py

async def render_prompt(
    self,
    name: str,
    arguments: dict[str, Any] | None,
    context: Context[LifespanContextT, RequestT],
) -> list[Message] | InputRequiredResult:
    """Render a prompt by name with arguments."""
    prompt = self.get_prompt(name)
    if not prompt:
        raise ValueError(f"Unknown prompt: {name}")

    return await prompt.render(arguments, context)