deleted unused files and folders. cleaned up front-end UI a bit. Tidied up the notebooks for both APIs. Added mcp.json config info in the README

README.md

@@ -19,4 +19,35 @@ The MCP server is defined inside `app.py` and is hosted on HuggingFace spaces us
 
 ## MCP Client
 
-The MCP client is defined inside `mcp_client.py` and allows interaction with the MCP server through server side events (SSE) transport.
+The MCP client is defined inside `mcp_client.py` and allows interaction with the MCP server through server side events (SSE) transport.
+
+For MCP clients that support SSE transport (Not Claude Desktop, see below for info), the following configuration can be used:
+
+```json
+{
+  "mcpServers": {
+    "gradio": {
+      "url": "https://agents-mcp-hackathon-f1-mcp-server.hf.space/gradio_api/mcp/sse"
+    }
+  }
+}
+```
+
+For Claude Desktop, the following configuration can instead be used, but make sure you have Node.js installed:
+
+```json
+{
+  "mcpServers": {
+    "gradio": {
+      "command": "npx",
+      "args": [
+        "mcp-remote",
+        "https://agents-mcp-hackathon-f1-mcp-server.hf.space/gradio_api/mcp/sse",
+        "--transport",
+        "sse-only"
+      ]
+    }
+  }
+}
+```
+

api_playground.ipynb

@@ -136,357 +136,6 @@
     "circuit_info = session.get_circuit_info()\n",
     "pprint(circuit_info)"
    ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "a5047955",
-   "metadata": {},
-   "source": [
-    "# OpenF1"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 3,
-   "id": "b5d31092",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "def make_request(api_action_string: str, debug: bool = False):\n",
-    "    try: \n",
-    "        response = urlopen(f\"https://api.openf1.org/v1/{api_action_string}\")\n",
-    "        data = json.loads(response.read().decode('utf-8'))\n",
-    "        if debug: pprint(data)\n",
-    "        return data\n",
-    "    except Exception as e:\n",
-    "        print(f\"Error: {e}\")"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 5,
-   "id": "599aeec3",
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "[{'brake': 0,\n",
-      "  'date': '2023-09-15T13:08:19.923000+00:00',\n",
-      "  'driver_number': 55,\n",
-      "  'drs': 12,\n",
-      "  'meeting_key': 1219,\n",
-      "  'n_gear': 8,\n",
-      "  'rpm': 11141,\n",
-      "  'session_key': 9159,\n",
-      "  'speed': 315,\n",
-      "  'throttle': 99},\n",
-      " {'brake': 100,\n",
-      "  'date': '2023-09-15T13:35:41.808000+00:00',\n",
-      "  'driver_number': 55,\n",
-      "  'drs': 8,\n",
-      "  'meeting_key': 1219,\n",
-      "  'n_gear': 8,\n",
-      "  'rpm': 11023,\n",
-      "  'session_key': 9159,\n",
-      "  'speed': 315,\n",
-      "  'throttle': 57}]\n"
-     ]
-    }
-   ],
-   "source": [
-    "# Respone object for OpenF1\n",
-    "\n",
-    "response = urlopen('https://api.openf1.org/v1/car_data?driver_number=55&session_key=9159&speed>=315')\n",
-    "data = json.loads(response.read().decode('utf-8'))\n",
-    "pprint(data)"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 19,
-   "id": "2b06a5c0",
-   "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/html": [
-       "<div>\n",
-       "<style scoped>\n",
-       "    .dataframe tbody tr th:only-of-type {\n",
-       "        vertical-align: middle;\n",
-       "    }\n",
-       "\n",
-       "    .dataframe tbody tr th {\n",
-       "        vertical-align: top;\n",
-       "    }\n",
-       "\n",
-       "    .dataframe thead th {\n",
-       "        text-align: right;\n",
-       "    }\n",
-       "</style>\n",
-       "<table border=\"1\" class=\"dataframe\">\n",
-       "  <thead>\n",
-       "    <tr style=\"text-align: right;\">\n",
-       "      <th></th>\n",
-       "      <th>meeting_key</th>\n",
-       "      <th>session_key</th>\n",
-       "      <th>location</th>\n",
-       "      <th>date_start</th>\n",
-       "      <th>date_end</th>\n",
-       "      <th>session_type</th>\n",
-       "      <th>session_name</th>\n",
-       "      <th>country_key</th>\n",
-       "      <th>country_code</th>\n",
-       "      <th>country_name</th>\n",
-       "      <th>circuit_key</th>\n",
-       "      <th>circuit_short_name</th>\n",
-       "      <th>gmt_offset</th>\n",
-       "      <th>year</th>\n",
-       "    </tr>\n",
-       "  </thead>\n",
-       "  <tbody>\n",
-       "    <tr>\n",
-       "      <th>0</th>\n",
-       "      <td>1262</td>\n",
-       "      <td>9964</td>\n",
-       "      <td>Barcelona</td>\n",
-       "      <td>2025-05-30T11:30:00+00:00</td>\n",
-       "      <td>2025-05-30T12:30:00+00:00</td>\n",
-       "      <td>Practice</td>\n",
-       "      <td>Practice 1</td>\n",
-       "      <td>1</td>\n",
-       "      <td>ESP</td>\n",
-       "      <td>Spain</td>\n",
-       "      <td>15</td>\n",
-       "      <td>Catalunya</td>\n",
-       "      <td>02:00:00</td>\n",
-       "      <td>2025</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>1</th>\n",
-       "      <td>1262</td>\n",
-       "      <td>9965</td>\n",
-       "      <td>Barcelona</td>\n",
-       "      <td>2025-05-30T15:00:00+00:00</td>\n",
-       "      <td>2025-05-30T16:00:00+00:00</td>\n",
-       "      <td>Practice</td>\n",
-       "      <td>Practice 2</td>\n",
-       "      <td>1</td>\n",
-       "      <td>ESP</td>\n",
-       "      <td>Spain</td>\n",
-       "      <td>15</td>\n",
-       "      <td>Catalunya</td>\n",
-       "      <td>02:00:00</td>\n",
-       "      <td>2025</td>\n",
-       "    </tr>\n",
-       "  </tbody>\n",
-       "</table>\n",
-       "</div>"
-      ],
-      "text/plain": [
-       "   meeting_key  session_key   location                 date_start  \\\n",
-       "0         1262         9964  Barcelona  2025-05-30T11:30:00+00:00   \n",
-       "1         1262         9965  Barcelona  2025-05-30T15:00:00+00:00   \n",
-       "\n",
-       "                    date_end session_type session_name  country_key  \\\n",
-       "0  2025-05-30T12:30:00+00:00     Practice   Practice 1            1   \n",
-       "1  2025-05-30T16:00:00+00:00     Practice   Practice 2            1   \n",
-       "\n",
-       "  country_code country_name  circuit_key circuit_short_name gmt_offset  year  \n",
-       "0          ESP        Spain           15          Catalunya   02:00:00  2025  \n",
-       "1          ESP        Spain           15          Catalunya   02:00:00  2025  "
-      ]
-     },
-     "execution_count": 19,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
-   "source": [
-    "# Get session\n",
-    "respone = make_request(\"sessions?country_name=Spain&year=2025\", debug=False)\n",
-    "df = pd.DataFrame(respone)\n",
-    "df.head(n=2)\n"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 18,
-   "id": "f13e4f1a",
-   "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/html": [
-       "<div>\n",
-       "<style scoped>\n",
-       "    .dataframe tbody tr th:only-of-type {\n",
-       "        vertical-align: middle;\n",
-       "    }\n",
-       "\n",
-       "    .dataframe tbody tr th {\n",
-       "        vertical-align: top;\n",
-       "    }\n",
-       "\n",
-       "    .dataframe thead th {\n",
-       "        text-align: right;\n",
-       "    }\n",
-       "</style>\n",
-       "<table border=\"1\" class=\"dataframe\">\n",
-       "  <thead>\n",
-       "    <tr style=\"text-align: right;\">\n",
-       "      <th></th>\n",
-       "      <th>meeting_key</th>\n",
-       "      <th>session_key</th>\n",
-       "      <th>location</th>\n",
-       "      <th>date_start</th>\n",
-       "      <th>date_end</th>\n",
-       "      <th>session_type</th>\n",
-       "      <th>session_name</th>\n",
-       "      <th>country_key</th>\n",
-       "      <th>country_code</th>\n",
-       "      <th>country_name</th>\n",
-       "      <th>circuit_key</th>\n",
-       "      <th>circuit_short_name</th>\n",
-       "      <th>gmt_offset</th>\n",
-       "      <th>year</th>\n",
-       "    </tr>\n",
-       "  </thead>\n",
-       "  <tbody>\n",
-       "    <tr>\n",
-       "      <th>0</th>\n",
-       "      <td>1262</td>\n",
-       "      <td>9966</td>\n",
-       "      <td>Barcelona</td>\n",
-       "      <td>2025-05-31T10:30:00+00:00</td>\n",
-       "      <td>2025-05-31T11:30:00+00:00</td>\n",
-       "      <td>Practice</td>\n",
-       "      <td>Practice 3</td>\n",
-       "      <td>1</td>\n",
-       "      <td>ESP</td>\n",
-       "      <td>Spain</td>\n",
-       "      <td>15</td>\n",
-       "      <td>Catalunya</td>\n",
-       "      <td>02:00:00</td>\n",
-       "      <td>2025</td>\n",
-       "    </tr>\n",
-       "  </tbody>\n",
-       "</table>\n",
-       "</div>"
-      ],
-      "text/plain": [
-       "   meeting_key  session_key   location                 date_start  \\\n",
-       "0         1262         9966  Barcelona  2025-05-31T10:30:00+00:00   \n",
-       "\n",
-       "                    date_end session_type session_name  country_key  \\\n",
-       "0  2025-05-31T11:30:00+00:00     Practice   Practice 3            1   \n",
-       "\n",
-       "  country_code country_name  circuit_key circuit_short_name gmt_offset  year  \n",
-       "0          ESP        Spain           15          Catalunya   02:00:00  2025  "
-      ]
-     },
-     "execution_count": 18,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
-   "source": [
-    "# Current session id (called during FP3 in Spain)\n",
-    "respone = make_request(\"sessions?session_key=latest\")\n",
-    "df = pd.DataFrame(respone)\n",
-    "df.head()"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "80a5699e",
-   "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/html": [
-       "<div>\n",
-       "<style scoped>\n",
-       "    .dataframe tbody tr th:only-of-type {\n",
-       "        vertical-align: middle;\n",
-       "    }\n",
-       "\n",
-       "    .dataframe tbody tr th {\n",
-       "        vertical-align: top;\n",
-       "    }\n",
-       "\n",
-       "    .dataframe thead th {\n",
-       "        text-align: right;\n",
-       "    }\n",
-       "</style>\n",
-       "<table border=\"1\" class=\"dataframe\">\n",
-       "  <thead>\n",
-       "    <tr style=\"text-align: right;\">\n",
-       "      <th></th>\n",
-       "      <th>meeting_key</th>\n",
-       "      <th>session_key</th>\n",
-       "      <th>location</th>\n",
-       "      <th>date_start</th>\n",
-       "      <th>date_end</th>\n",
-       "      <th>session_type</th>\n",
-       "      <th>session_name</th>\n",
-       "      <th>country_key</th>\n",
-       "      <th>country_code</th>\n",
-       "      <th>country_name</th>\n",
-       "      <th>circuit_key</th>\n",
-       "      <th>circuit_short_name</th>\n",
-       "      <th>gmt_offset</th>\n",
-       "      <th>year</th>\n",
-       "    </tr>\n",
-       "  </thead>\n",
-       "  <tbody>\n",
-       "    <tr>\n",
-       "      <th>0</th>\n",
-       "      <td>1262</td>\n",
-       "      <td>9966</td>\n",
-       "      <td>Barcelona</td>\n",
-       "      <td>2025-05-31T10:30:00+00:00</td>\n",
-       "      <td>2025-05-31T11:30:00+00:00</td>\n",
-       "      <td>Practice</td>\n",
-       "      <td>Practice 3</td>\n",
-       "      <td>1</td>\n",
-       "      <td>ESP</td>\n",
-       "      <td>Spain</td>\n",
-       "      <td>15</td>\n",
-       "      <td>Catalunya</td>\n",
-       "      <td>02:00:00</td>\n",
-       "      <td>2025</td>\n",
-       "    </tr>\n",
-       "  </tbody>\n",
-       "</table>\n",
-       "</div>"
-      ],
-      "text/plain": [
-       "   meeting_key  session_key   location                 date_start  \\\n",
-       "0         1262         9966  Barcelona  2025-05-31T10:30:00+00:00   \n",
-       "\n",
-       "                    date_end session_type session_name  country_key  \\\n",
-       "0  2025-05-31T11:30:00+00:00     Practice   Practice 3            1   \n",
-       "\n",
-       "  country_code country_name  circuit_key circuit_short_name gmt_offset  year  \n",
-       "0          ESP        Spain           15          Catalunya   02:00:00  2025  "
-      ]
-     },
-     "execution_count": 5,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
-   "source": [
-    "# Current session id V2 (called between FP3 and Quali in Spain)\n",
-    "respone = make_request(\"sessions?session_key=latest\")\n",
-    "df = pd.DataFrame(respone)\n",
-    "df.head()\n",
-    "# session_key=latest points to the current or the most recent session NOT the upcoming one"
-   ]
   }
  ],
  "metadata": {

app.py

@@ -118,6 +118,10 @@ with gr.Blocks() as markdown_tab:
     Use the tabs above to navigate between different sections and explore the wealth of F1 data available at your fingertips.
     """)
 
+
+
+
+
 named_interfaces = {
     "About": markdown_tab,
     "Driver Championship Standings": iface_driver_championship_standings,

mcp_client.py

@@ -52,7 +52,7 @@ if __name__ == "__main__":
         tools = mcp_client.get_tools()
 
         print("### MCP tools ### ")
-        print("\n".join(f"{i}: {t.name}: {t.description}" for i,t in enumerate(tools)))
+        print("\n".join(f"Tool {1+i}: {t.name}: {t.description}" for i,t in enumerate(tools)))
 
         if only_list_tools:
             mcp_client.disconnect()
@@ -68,9 +68,9 @@ if __name__ == "__main__":
             )
         else:
             model = InferenceClientModel(
-                model_id="Qwen/Qwen2.5-32B-Instruct",
-                provider="",
-                token=os.getenv("HF_TOKEN")
+                model_id="deepseek-ai/DeepSeek-R1",
+                provider="nebius",
+                api_key=os.getenv("NEBIUS_API_KEY")
             )
 
         agent = ToolCallingAgent(tools=[*tools], model=model)

openf1_tools.py

@@ -161,9 +161,5 @@ if __name__ == "__main__":
     data = get_api_endpoint("sessions")
     pprint(data) 
 
-
     pprint(get_endpoint_info("sessions"))
 
-
-    # response = send_request(data["api_string"])
-    # pprint(response)

tests/test_resource_mappings.py

@@ -1,16 +0,0 @@
-""" Tests for resource mappings """
-
-import os
-import json
-
-
-# Load in driver names and numbers
-resource_dir = os.path.join(os.path.dirname(__file__), "..", "assets")
-driver_names = json.load(open(os.path.join(resource_dir, "driver_names.json")))
-driver_numbers = json.load(open(os.path.join(resource_dir, "driver_numbers.json")))
-
-for name in driver_names["drivers"]:
-    number = driver_numbers.get(name, None)
-    if number is None:
-        raise ValueError(f"Driver {name} does not have a driver number")
-print("All driver names and numbers are mapped")

utils/time_utils.py

@@ -1,13 +0,0 @@
-import datetime
-
-
-
-def get_current_time():
-    """
-    Returns the current time in the format: HH:MM:SS
-    """
-    # NOTE: I can perhaps modify what "now" is to instead be at a past F1 
-    # race when testing real-time tools
-    return datetime.datetime.now().strftime("%H:%M:%S")
-
-