Rec-MCP

Instructions

Implementation Reference

• ridb_mcp_server.py:9-20 (handler)

  The main tool handler function that invokes the helper to find camping near a city and returns formatted JSON.

  def find_campgrounds(location_name: str, radius: int = 25, limit: int = 50 ):
      """Find camping facilities near a specified location.
  
      Searches for camping facilities within a customizable radius of a city using the
      Recreation Information Database (RIDB) API. First geocodes the city to get coordinates,
      then searches for campgrounds and camping facilities in the surrounding area.
  
      Returns a JSON string containing facility information including any available image URLs.
       """
  
      camping_data = find_camping_near_city(location_name, radius=25, limit=10)
      return json.dumps(camping_data, indent=4)

• ridb_mcp_server.py:8-8 (registration)

  Decorator registering the find_campgrounds function as an MCP tool.

  @mcp.tool("find_campgrounds")

• api/ridb.py:114-145 (helper)

  Helper function that performs geocoding via Google API and fetches campground data from RIDB API.

  def find_camping_near_city(location_name: str, radius: int = 25, limit: int = 50) -> Optional[Dict[str, Any]]:
      """
      Find camping facilities near a city or location combining geocoding and recreation facility search.
  
      Args:
          location_name (str): Name of a location to search for
          radius (int): Search radius in miles (default: 25)
          limit (int): Maximum number of results to return (default: 50)
  
      Returns:
          Optional[Dict[str, Any]]: Dictionary with facilities data if found, None if error
      """
      # First, get the coordinates for the city
      coordinates = get_city_coordinates(location_name)
  
      if coordinates is None:
          print(f"Could not find coordinates for city: {location_name}")
          return None
  
      latitude, longitude = coordinates
  
      # Then, search for camping facilities near those coordinates
      facilities = get_camping_facilities(latitude, longitude, radius, limit)
  
      if facilities and "RECDATA" in facilities:
          facility_count = len(facilities["RECDATA"])
          print(f"Found {facility_count} camping facilities within {radius} miles of {location_name}")
          return facilities
      else:
          print(f"No camping facilities found within {radius} miles of {location_name}")
          return None

• api/ridb.py:12-62 (helper)

  Supporting function to geocode the location name to lat/long using Google Maps API.

  def get_city_coordinates(location_name: str) -> Optional[Tuple[float, float]]:
      """
      Get latitude and longitude coordinates for a city using Google Maps Geocoding API.
  
      Args:
          location_name (str): Name of a location to search for.
  
      Returns:
          Optional[Tuple[float, float]]: Tuple of (latitude, longitude) if found, None if not found
  
      Raises:
          requests.RequestException: If there's an error with the API request
      """
      base_url = "https://maps.googleapis.com/maps/api/geocode/json"
  
      params = {
          "key": GOOGLE_API_KEY,
          "address": location_name,
      }
  
      try:
          response = requests.get(base_url, params=params)
          response.raise_for_status()  # Raises an HTTPError for bad responses
  
          data = response.json()
  
          # Check if results were found and status is OK
          if data.get("status") == "OK" and "results" in data and len(data["results"]) > 0:
              # Get the first result
              first_result = data["results"][0]
              location = first_result["geometry"]["location"]
              latitude = location["lat"]
              longitude = location["lng"]
              
              return (latitude, longitude)
            
          else:
              status = data.get("status", "UNKNOWN")
              print(f"No results found for city: {location_name}. Status: {status}")
              return None
  
      except requests.RequestException as e:
          print(f"Error making API request: {e}")
          raise
      except KeyError as e:
          print(f"Unexpected response format: {e}")
          return None
      except Exception as e:
          print(f"Unexpected error: {e}")
          return None

• api/ridb.py:63-113 (helper)

  Supporting function to query RIDB API for camping facilities near coordinates.

  def get_camping_facilities(latitude: float, longitude: float, radius: int = 25,
                             limit: int = 50, offset: int = 0, activity: str = "CAMPING") -> Optional[Dict[str, Any]]:
      """
      Get camping facilities near given coordinates using Recreation.gov API.
      Args:
          latitude (float): Latitude coordinate
          longitude (float): Longitude coordinate
          radius (int): Search radius in miles (default: 25)
          limit (int): Maximum number of results to return (default: 50)
          offset (int): Number of results to skip (default: 0)
          activity (str): Activity type to search for (default: "CAMPING")
      Returns:
          Optional[Dict[str, Any]]: Dictionary with facilities data if found, None if error
      Raises:
          requests.RequestException: If there's an error with the API request
      """
      # Ensure RIDB_API_KEY is available
      if not RIDB_API_KEY:
          raise ValueError("RIDB_API_KEY is not configured")
      
      base_url = "https://ridb.recreation.gov/api/v1/facilities"
      params = {
          "limit": limit,
          "offset": offset,
          "latitude": latitude,
          "longitude": longitude,
          "radius": radius,
          "activity": activity
      }
      headers = {
          "accept": "application/json",
          "apikey": RIDB_API_KEY
      }
  
      try:
          response = requests.get(base_url, params=params, headers=headers)
          response.raise_for_status()
  
          data = response.json()
  
          if data and "RECDATA" in data:
              return data
  
      except requests.RequestException as e:
          print(f"Error making API request to Recreation.gov: {e}")
          raise
      except Exception as e:
          print(f"Unexpected error: {e}")
          raise  # Re-raise instead of returning None for consistency