Initial commit

.gitignore

@@ -0,0 +1,3 @@
+__pycache__
+.env
+.idea

app.py

@@ -0,0 +1,91 @@
+import gradio as gr
+from camptocamp_api import CamptocampAPI
+from typing import Tuple, Optional
+
+
+# Instantiate API
+c2c = CamptocampAPI(language="en")
+
+def get_recent_outings(
+    west: float, south: float, east: float, north: float,
+    start_date: Optional[str], end_date: Optional[str],
+    activity: Optional[str], limit: int
+):
+    bbox = (west, south, east, north)
+    date_range = (start_date, end_date) if start_date and end_date else None
+    return c2c.get_recent_outings(bbox, date_range, activity, limit)
+
+def search_routes_by_activity(
+    west: float, south: float, east: float, north: float,
+    activity: str, limit: int
+):
+    bbox = (west, south, east, north)
+    return c2c.search_routes_by_activity(bbox, activity, limit)
+
+def get_route_details(route_id: int):
+    return c2c.get_route_details(route_id)
+
+def search_waypoints(
+    west: float, south: float, east: float, north: float,
+    limit: int
+):
+    bbox = (west, south, east, north)
+    return c2c.search_waypoints(bbox, limit)
+
+
+with gr.Blocks(title="Camptocamp API MCP") as demo:
+    gr.Markdown("# 🏔️ Camptocamp API Interface")
+
+    with gr.Tab("Recent Outings"):
+        with gr.Row():
+            west = gr.Number(label="West")
+            south = gr.Number(label="South")
+            east = gr.Number(label="East")
+            north = gr.Number(label="North")
+        with gr.Row():
+            start_date = gr.Textbox(label="Start Date (YYYY-MM-DD)")
+            end_date = gr.Textbox(label="End Date (YYYY-MM-DD)")
+            activity = gr.Textbox(label="Activity (e.g. hiking, skiing)")
+            limit = gr.Number(label="Limit", value=5)
+        outings_output = gr.JSON()
+        outings_btn = gr.Button("Get Outings")
+        outings_btn.click(get_recent_outings,
+                          inputs=[west, south, east, north, start_date, end_date, activity, limit],
+                          outputs=outings_output)
+
+    with gr.Tab("Routes"):
+        with gr.Row():
+            r_west = gr.Number(label="West")
+            r_south = gr.Number(label="South")
+            r_east = gr.Number(label="East")
+            r_north = gr.Number(label="North")
+        r_activity = gr.Textbox(label="Activity")
+        r_limit = gr.Number(label="Limit", value=5)
+        route_output = gr.JSON()
+        route_btn = gr.Button("Search Routes")
+        route_btn.click(search_routes_by_activity,
+                        inputs=[r_west, r_south, r_east, r_north, r_activity, r_limit],
+                        outputs=route_output)
+
+    with gr.Tab("Route Details"):
+        route_id_input = gr.Number(label="Route ID")
+        route_details_output = gr.JSON()
+        route_details_btn = gr.Button("Get Route Details")
+        route_details_btn.click(get_route_details,
+                                inputs=[route_id_input],
+                                outputs=route_details_output)
+
+    with gr.Tab("Waypoints"):
+        with gr.Row():
+            w_west = gr.Number(label="West")
+            w_south = gr.Number(label="South")
+            w_east = gr.Number(label="East")
+            w_north = gr.Number(label="North")
+        w_limit = gr.Number(label="Limit", value=5)
+        waypoints_output = gr.JSON()
+        waypoints_btn = gr.Button("Search Waypoints")
+        waypoints_btn.click(search_waypoints,
+                            inputs=[w_west, w_south, w_east, w_north, w_limit],
+                            outputs=waypoints_output)
+
+demo.launch()

camptocamp_api.py

@@ -0,0 +1,126 @@
+import requests
+from typing import Tuple, Optional, Dict, Any
+
+
+class CamptocampAPI:
+    """
+    A Python wrapper for the Camptocamp.org REST API v6.
+    Supports querying outings, routes, waypoints, and more.
+    """
+
+    BASE_URL = "https://api.camptocamp.org"
+
+    def __init__(self, language: str = "en") -> None:
+        """
+        Initialize the API client.
+
+        Args:
+            language (str): Language code for results ('en', 'fr', etc.).
+        """
+        self.language = language
+
+    def _request(self, endpoint: str, params: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Internal method to send a GET request to the Camptocamp API.
+
+        Args:
+            endpoint (str): API endpoint (e.g., "/outings").
+            params (Dict): Dictionary of query parameters.
+
+        Returns:
+            Dict: Parsed JSON response.
+        """
+        params["pl"] = self.language
+        url = f"{self.BASE_URL}{endpoint}"
+        response = requests.get(url, params=params)
+        response.raise_for_status()
+        return response.json()
+
+    def get_recent_outings(
+        self,
+        bbox: Tuple[float, float, float, float],
+        date_range: Optional[Tuple[str, str]] = None,
+        activity: Optional[str] = None,
+        limit: int = 10,
+    ) -> Dict[str, Any]:
+        """
+        Get recent outings around a specific location and date.
+
+        Args:
+            bbox (Tuple[float, float, float, float]): Bounding box as (west, south, east, north).
+            date_range (Optional[Tuple[str, str]]): Date range (start, end) in YYYY-MM-DD format.
+            activity (Optional[str]): Activity filter (e.g., "climbing", "hiking").
+            limit (int): Max number of results.
+
+        Returns:
+            Dict: API response containing outings.
+        """
+        params = {
+            "bbox": ",".join(map(str, bbox)),
+            "limit": limit,
+            "orderby": "-date",
+        }
+        if date_range:
+            params["date"] = f"{date_range[0]},{date_range[1]}"
+        if activity:
+            params["act"] = activity
+
+        return self._request("/outings", params)
+
+    def search_routes_by_activity(
+        self,
+        bbox: Tuple[float, float, float, float],
+        activity: str,
+        limit: int = 10,
+    ) -> Dict[str, Any]:
+        """
+        Search for routes in a given area and activity type.
+
+        Args:
+            bbox (Tuple[float, float, float, float]): Bounding box as (west, south, east, north).
+            activity (str): Activity filter (e.g., "rock_climbing").
+            limit (int): Max number of results.
+
+        Returns:
+            Dict: API response containing route data.
+        """
+        params = {
+            "bbox": ",".join(map(str, bbox)),
+            "act": activity,
+            "limit": limit,
+            "orderby": "-date",
+        }
+        return self._request("/routes", params)
+
+    def get_route_details(self, route_id: int) -> Dict[str, Any]:
+        """
+        Retrieve full route information by its ID.
+
+        Args:
+            route_id (int): Camptocamp route ID.
+
+        Returns:
+            Dict: Full route document with metadata and description.
+        """
+        return self._request(f"/routes/{route_id}/{self.language}", {})
+
+    def search_waypoints(
+        self,
+        bbox: Tuple[float, float, float, float],
+        limit: int = 10,
+    ) -> Dict[str, Any]:
+        """
+        Get waypoints (e.g., huts, summits) within a given area.
+
+        Args:
+            bbox (Tuple[float, float, float, float]): Bounding box as (west, south, east, north).
+            limit (int): Max number of results.
+
+        Returns:
+            Dict: API response with waypoint data.
+        """
+        params = {
+            "bbox": ",".join(map(str, bbox)),
+            "limit": limit,
+        }
+        return self._request("/waypoints", params)

main.py

@@ -0,0 +1,16 @@
+# This is a sample Python script.
+
+# Press ⌃R to execute it or replace it with your code.
+# Press Double ⇧ to search everywhere for classes, files, tool windows, actions, and settings.
+
+
+def print_hi(name):
+    # Use a breakpoint in the code line below to debug your script.
+    print(f'Hi, {name}')  # Press ⌘F8 to toggle the breakpoint.
+
+
+# Press the green button in the gutter to run the script.
+if __name__ == '__main__':
+    print_hi('PyCharm')
+
+# See PyCharm help at https://www.jetbrains.com/help/pycharm/

requirements.txt

@@ -0,0 +1,2 @@
+gradio>=4.0
+requests>=2.0