fastmcp/examples/prompts_as_tools/server.py

"""Example: Expose prompts as tools using the PromptsAsTools plugin.

This example shows how to use PromptsAsTools to make prompts accessible
to clients that only support tools (not the prompts protocol).

Run with:
    uv run python examples/prompts_as_tools/server.py
"""

from fastmcp import FastMCP
from fastmcp.server.plugins.prompts_as_tools import PromptsAsTools

mcp = FastMCP("Prompt Tools Demo", plugins=[PromptsAsTools()])


# Simple prompt without arguments
@mcp.prompt
def explain_concept(concept: str) -> str:
    """Explain a programming concept."""
    return f"""Please explain the following programming concept in simple terms:

{concept}

Include:
- A clear definition
- Common use cases
- A simple example
"""


# Prompt with multiple arguments
@mcp.prompt
def analyze_code(code: str, language: str = "python", focus: str = "all") -> str:
    """Analyze code for potential issues."""
    return f"""Analyze this {language} code:

```{language}
{code}
```

Focus on: {focus}

Please identify:
- Potential bugs or errors
- Performance issues
- Code style improvements
- Security concerns
"""


# Prompt with required and optional arguments
@mcp.prompt
def review_pull_request(
    title: str, description: str, diff: str, guidelines: str = ""
) -> str:
    """Review a pull request."""
    guidelines_section = (
        f"\n\nGuidelines to follow:\n{guidelines}" if guidelines else ""
    )

    return f"""Review this pull request:

**Title:** {title}

**Description:**
{description}

**Diff:**
```
{diff}
```{guidelines_section}

Please provide:
- Summary of changes
- Potential issues or concerns
- Suggestions for improvement
- Overall recommendation (approve/request changes)
"""


# PromptsAsTools (registered at construction above) adds list_prompts
# and get_prompt synthetic tools so tools-only clients can drive prompts.


if __name__ == "__main__":
    mcp.run()