Edinburgh Festivals MCP Server

import json import os from typing import Dict, List from fastmcp import FastMCP import edfestcli import gmaps cli = edfestcli.EdFestCli() gmaps_cli = gmaps.GMAPS() mcp = FastMCP("My MCP Server") @mcp.tool(description="Search Edinburgh festival venues") def edinburgh_festival_venues( festival: str = "international", postcode: str = None, name: str = None, year: str = "2025", number_of_results=25, page=0, ) -> List[Dict]: """ Searches Edinburgh festival venues. :param festival: The type of festival to search for venues in. :param postcode: The postcode to filter venues by. :param name: The name of the venue to search for. :param year: The year of the festival. :return: A dictionary containing venue information. :param number_of_results: The maximum number of results to retrieve, up to 100 at a time. :param page: The page number for pagination, starting from 0. : """ params = { "festival": festival, "year": year, "postcode": postcode, "name": name, "size": number_of_results, "page": page, } filtered_params = {k: v for k, v in params.items() if v} results = cli.venues(filtered_params) return results @mcp.tool(description="Calculate route between venues") def edinburgh_festival_venue_routes(origin: str, destination: str) -> Dict: """ Calculates the route between two venues. :param origin: The starting venue :param destination: The destination venue. :return: A dictionary containing route information:. """ gmaps_cli = gmaps.GMAPS() if not gmaps_cli.enabled: return {"error": "Google Maps API key is not set. This tool is not available."} directions = gmaps_cli.get_directions(origin, destination, mode="walking") return directions @mcp.prompt(description="Find a route between two venues in Edinburgh") def edinburgh_festival_venue_route_prompt( start_location: str, destination: str, mode="walking" ) -> str: return f"""find a route between {start_location}, Edinburgh, UK and {destination}, Edinburgh, UK using {mode} mode of transport.""" @mcp.prompt(description="Ask about Edinburgh Fringe festival in 2025") def edinburgh_fringe_festival_2025_prompt(query: str) -> str: return f"Answer this question about the Edinburgh Fringe festival in 2025: {query}" @mcp.tool() def edinburgh_festival_events( datetime_from="2025-01-01 00:00:00", datetime_to="2025-12-31 23:59:59", festival="international", genre=None, venue_name=None, search_text=None, title=None, artist=None, number_of_results=25, page=0, year="*", ) -> List[Dict]: """ Searches this year's Edinburgh festival events. :param datetime_from: An optional ISO8601-like timestamp. e.g. '2025-08-12 00:00:00' :param datetime_to: An optional ISO8601-like timestamp. e.g. '2025-08-12 00:00:00' :param festival: possible values are fringe, demofringe, jazz, book, international, tattoo, art, hogmanay, science, imaginate, film, mela, storytelling. :param genre: The genre of the show. This will vary by festival type but may include comedy, theatre etc :param venue_name: The genre of the show. This will vary by festival type but may include comedy, theatre etc :param search_text: description of the show to search for. :param artist: Name of an artist or performer to search for. :param title: the title of the show to search for. :param year: The year of the festival. Defaults to "*", which means all years. :param datetime_from: The start date and time for the search range. :param number_of_results: The maximum number of results to retrieve, up to 100 at a time. :param page: The page number for pagination, starting from 0. :return: """ params = { "festival": festival, "year": year, "date_from": datetime_from.replace("T", " "), "date_to": datetime_to.replace("T", " "), "genre": genre, "venue_name": venue_name, "description": search_text, "artist": artist, "title": title, "size": number_of_results, "page": page, } ## If year is "*", we remove the date filters if year == "*": del params["date_from"] del params["date_to"] filtered_params = {k: v for k, v in params.items() if v} results = cli.events(filtered_params) # for r in results: # del r['images'] return results if __name__ == "__main__": mcp.run(transport="stdio")