Add MCP

[koxudaxi]

Progress on: #725

examples

"""Example of MCP server for book recommendations."""

import asyncio
from pathlib import Path

from mirascope.mcp import MCPServer

# Create a server for book recommendations
app = MCPServer("book-recommend")


@app.tool()
def get_book(genre: str) -> str:
    """Get a recommendation for a specific book genre.

    Args:
        genre: Genre of book (fantasy, mystery, sci-fi, etc.)
    """
    book_recommendations = {
        "fantasy": "The Name of the Wind by Patrick Rothfuss",
        "mystery": "The Silent Patient by Alex Michaelides",
        "sci-fi": "Project Hail Mary by Andy Weir",
        "romance": "The Love Hypothesis by Ali Hazelwood",
        "historical": "The Seven Husbands of Evelyn Hugo by Taylor Jenkins Reid"
    }
    return book_recommendations.get(genre, "Please specify a valid genre")


@app.resource(
    uri="file://books.txt",
    name="Books Database",
    mime_type="text/plain",
    description="Curated database of book recommendations by genre"
)
async def read_books_database():
    """Read the books database file."""
    data = Path(__file__).parent / "books.txt"
    with data.open() as f:
        return f.read()


@app.prompt()
def recommend_book(genre: str) -> str:
    """Get book recommendations by genre.

    Args:
        genre: Genre of book to recommend (fantasy, mystery, sci-fi, etc.)
    """
    return f"Recommend a {genre} book"


async def main():
    """Run the book recommendation server."""
    await app.run()


if __name__ == "__main__":
    asyncio.run(main())

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 100.00%. Comparing base (b28358b) to head (272a9b8).
Report is 10 commits behind head on release/v1.12.

Additional details and impacted files

@@               Coverage Diff                @@
##           release/v1.12      #727    +/-   ##
================================================
  Coverage         100.00%   100.00%            
================================================
  Files                399       403     +4     
  Lines              13394     14192   +798     
================================================
+ Hits               13394     14192   +798     

Flag	Coverage Δ
tests	100.00% <100.00%> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

The base branch was changed.