feat: implement MCP server and dashboard for football data platform

Add complete Nike football data platform with: - FastMCP server exposing football data tools over HTTP - RapidAPI client for free-api-live-football-data integration - Bootstrap web dashboard with live match/standings views - REST API endpoints for dashboard consumption - Docker support with multi-stage build - Comprehensive README with architecture docs - Minimal .gitignore replacing verbose Python template
2026-03-21 18:19:42 +00:00
parent b8689d530a
commit ee8436d5b8
81 changed files with 50251 additions and 176 deletions
--- a/docs/api_samples/sportsdb/03_v1_next_tfc.json
+++ b/docs/api_samples/sportsdb/03_v1_next_tfc.json
@@ -0,0 +1,484 @@
+{
+  "events": [
+    {
+      "idEvent": "2406753",
+      "idAPIfootball": "1490151",
+      "strTimestamp": "2026-03-14T17:00:00",
+      "strEvent": "Toronto FC vs New York Red Bulls",
+      "strEventAlternate": "New York Red Bulls @ Toronto FC",
+      "strFilename": "American Major League Soccer 2026-03-14 Toronto FC vs New York Red Bulls",
+      "strSport": "Soccer",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strLeagueBadge": "https://r2.thesportsdb.com/images/media/league/badge/dqo6r91549878326.png",
+      "strSeason": "2026",
+      "strDescriptionEN": null,
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "New York Red Bulls",
+      "intHomeScore": null,
+      "intRound": "4",
+      "intAwayScore": null,
+      "intSpectators": null,
+      "strOfficial": "",
+      "dateEvent": "2026-03-14",
+      "dateEventLocal": null,
+      "strTime": "17:00:00",
+      "strTimeLocal": null,
+      "strGroup": null,
+      "idHomeTeam": "134148",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "idAwayTeam": "134156",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/suytvy1473536462.png",
+      "intScore": null,
+      "intScoreVotes": null,
+      "strResult": null,
+      "idVenue": "16782",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strCity": null,
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/4wgouh1706716030.jpg",
+      "strSquare": "https://r2.thesportsdb.com/images/media/event/square/l0z2931706714037.jpg",
+      "strFanart": null,
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/rt3hqv1706713405.jpg",
+      "strBanner": "https://r2.thesportsdb.com/images/media/event/banner/6lpnqd1706718691.jpg",
+      "strMap": null,
+      "strTweet1": null,
+      "strVideo": null,
+      "strStatus": "Not Started",
+      "strPostponed": "no",
+      "strLocked": "unlocked"
+    },
+    {
+      "idEvent": "2406768",
+      "idAPIfootball": "1490165",
+      "strTimestamp": "2026-03-21T17:00:00",
+      "strEvent": "Toronto FC vs Columbus Crew",
+      "strEventAlternate": "Columbus Crew @ Toronto FC",
+      "strFilename": "American Major League Soccer 2026-03-21 Toronto FC vs Columbus Crew",
+      "strSport": "Soccer",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strLeagueBadge": "https://r2.thesportsdb.com/images/media/league/badge/dqo6r91549878326.png",
+      "strSeason": "2026",
+      "strDescriptionEN": null,
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "Columbus Crew",
+      "intHomeScore": null,
+      "intRound": "5",
+      "intAwayScore": null,
+      "intSpectators": null,
+      "strOfficial": "",
+      "dateEvent": "2026-03-21",
+      "dateEventLocal": null,
+      "strTime": "17:00:00",
+      "strTimeLocal": null,
+      "strGroup": null,
+      "idHomeTeam": "134148",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "idAwayTeam": "134152",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/dzs8cp1629059854.png",
+      "intScore": null,
+      "intScoreVotes": null,
+      "strResult": null,
+      "idVenue": "16782",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strCity": null,
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/gdbc391706715993.jpg",
+      "strSquare": "https://r2.thesportsdb.com/images/media/event/square/pp3i0l1706714009.jpg",
+      "strFanart": null,
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/xab3h11706713371.jpg",
+      "strBanner": "https://r2.thesportsdb.com/images/media/event/banner/y2lohb1706718675.jpg",
+      "strMap": null,
+      "strTweet1": null,
+      "strVideo": null,
+      "strStatus": "Not Started",
+      "strPostponed": "no",
+      "strLocked": "unlocked"
+    },
+    {
+      "idEvent": "2406782",
+      "idAPIfootball": "1490180",
+      "strTimestamp": "2026-04-04T17:00:00",
+      "strEvent": "Toronto FC vs Colorado Rapids",
+      "strEventAlternate": "Colorado Rapids @ Toronto FC",
+      "strFilename": "American Major League Soccer 2026-04-04 Toronto FC vs Colorado Rapids",
+      "strSport": "Soccer",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strLeagueBadge": "https://r2.thesportsdb.com/images/media/league/badge/dqo6r91549878326.png",
+      "strSeason": "2026",
+      "strDescriptionEN": null,
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "Colorado Rapids",
+      "intHomeScore": null,
+      "intRound": "6",
+      "intAwayScore": null,
+      "intSpectators": null,
+      "strOfficial": "",
+      "dateEvent": "2026-04-04",
+      "dateEventLocal": null,
+      "strTime": "17:00:00",
+      "strTimeLocal": null,
+      "strGroup": null,
+      "idHomeTeam": "134148",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "idAwayTeam": "134794",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/uppupv1473536412.png",
+      "intScore": null,
+      "intScoreVotes": null,
+      "strResult": null,
+      "idVenue": "16782",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strCity": null,
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/tuqxzy1771753493.jpg",
+      "strSquare": "https://r2.thesportsdb.com/images/media/event/square/oqmxey1771754131.jpg",
+      "strFanart": null,
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/re0wo71771753307.jpg",
+      "strBanner": "https://r2.thesportsdb.com/images/media/event/banner/b4c9171771753983.jpg",
+      "strMap": null,
+      "strTweet1": null,
+      "strVideo": null,
+      "strStatus": "Not Started",
+      "strPostponed": "no",
+      "strLocked": "unlocked"
+    },
+    {
+      "idEvent": "2406798",
+      "idAPIfootball": "1490196",
+      "strTimestamp": "2026-04-11T17:00:00",
+      "strEvent": "Toronto FC vs FC Cincinnati",
+      "strEventAlternate": "FC Cincinnati @ Toronto FC",
+      "strFilename": "American Major League Soccer 2026-04-11 Toronto FC vs FC Cincinnati",
+      "strSport": "Soccer",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strLeagueBadge": "https://r2.thesportsdb.com/images/media/league/badge/dqo6r91549878326.png",
+      "strSeason": "2026",
+      "strDescriptionEN": null,
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "FC Cincinnati",
+      "intHomeScore": null,
+      "intRound": "7",
+      "intAwayScore": null,
+      "intSpectators": null,
+      "strOfficial": "",
+      "dateEvent": "2026-04-11",
+      "dateEventLocal": null,
+      "strTime": "17:00:00",
+      "strTimeLocal": null,
+      "strGroup": null,
+      "idHomeTeam": "134148",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "idAwayTeam": "136688",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/vvhsqc1707631046.png",
+      "intScore": null,
+      "intScoreVotes": null,
+      "strResult": null,
+      "idVenue": "16782",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strCity": null,
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/oag8hp1674489270.jpg",
+      "strSquare": "https://r2.thesportsdb.com/images/media/event/square/r6l2dl1706713803.jpg",
+      "strFanart": null,
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/p5mxz71706713223.jpg",
+      "strBanner": "https://r2.thesportsdb.com/images/media/event/banner/3do5bk1706718587.jpg",
+      "strMap": null,
+      "strTweet1": null,
+      "strVideo": null,
+      "strStatus": "Not Started",
+      "strPostponed": "no",
+      "strLocked": "unlocked"
+    },
+    {
+      "idEvent": "2406813",
+      "idAPIfootball": "1490212",
+      "strTimestamp": "2026-04-18T17:00:00",
+      "strEvent": "Toronto FC vs Austin FC",
+      "strEventAlternate": "Austin FC @ Toronto FC",
+      "strFilename": "American Major League Soccer 2026-04-18 Toronto FC vs Austin FC",
+      "strSport": "Soccer",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strLeagueBadge": "https://r2.thesportsdb.com/images/media/league/badge/dqo6r91549878326.png",
+      "strSeason": "2026",
+      "strDescriptionEN": null,
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "Austin FC",
+      "intHomeScore": null,
+      "intRound": "8",
+      "intAwayScore": null,
+      "intSpectators": null,
+      "strOfficial": "",
+      "dateEvent": "2026-04-18",
+      "dateEventLocal": null,
+      "strTime": "17:00:00",
+      "strTimeLocal": null,
+      "strGroup": null,
+      "idHomeTeam": "134148",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "idAwayTeam": "140079",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/a3dlg61595434277.png",
+      "intScore": null,
+      "intScoreVotes": null,
+      "strResult": null,
+      "idVenue": "16782",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strCity": null,
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/adf29m1771753504.jpg",
+      "strSquare": "https://r2.thesportsdb.com/images/media/event/square/ko7gbq1771754143.jpg",
+      "strFanart": null,
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/c7qigg1771753319.jpg",
+      "strBanner": "https://r2.thesportsdb.com/images/media/event/banner/iitgo81771753993.jpg",
+      "strMap": null,
+      "strTweet1": null,
+      "strVideo": null,
+      "strStatus": "Not Started",
+      "strPostponed": "no",
+      "strLocked": "unlocked"
+    },
+    {
+      "idEvent": "2406829",
+      "idAPIfootball": "1490227",
+      "strTimestamp": "2026-04-22T23:30:00",
+      "strEvent": "Toronto FC vs Philadelphia Union",
+      "strEventAlternate": "Philadelphia Union @ Toronto FC",
+      "strFilename": "American Major League Soccer 2026-04-22 Toronto FC vs Philadelphia Union",
+      "strSport": "Soccer",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strLeagueBadge": "https://r2.thesportsdb.com/images/media/league/badge/dqo6r91549878326.png",
+      "strSeason": "2026",
+      "strDescriptionEN": null,
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "Philadelphia Union",
+      "intHomeScore": null,
+      "intRound": "9",
+      "intAwayScore": null,
+      "intSpectators": null,
+      "strOfficial": "",
+      "dateEvent": "2026-04-22",
+      "dateEventLocal": null,
+      "strTime": "23:30:00",
+      "strTimeLocal": null,
+      "strGroup": null,
+      "idHomeTeam": "134148",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "idAwayTeam": "134142",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/gyznyo1602103682.png",
+      "intScore": null,
+      "intScoreVotes": null,
+      "strResult": null,
+      "idVenue": "16782",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strCity": null,
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/qx2k6k1706715901.jpg",
+      "strSquare": "https://r2.thesportsdb.com/images/media/event/square/ail0fh1706713966.jpg",
+      "strFanart": null,
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/8sfg181706713309.jpg",
+      "strBanner": "https://r2.thesportsdb.com/images/media/event/banner/z0ucvs1706718638.jpg",
+      "strMap": null,
+      "strTweet1": null,
+      "strVideo": null,
+      "strStatus": "Not Started",
+      "strPostponed": "no",
+      "strLocked": "unlocked"
+    },
+    {
+      "idEvent": "2406839",
+      "idAPIfootball": "1490237",
+      "strTimestamp": "2026-04-25T17:00:00",
+      "strEvent": "Toronto FC vs Atlanta United",
+      "strEventAlternate": "Atlanta United @ Toronto FC",
+      "strFilename": "American Major League Soccer 2026-04-25 Toronto FC vs Atlanta United",
+      "strSport": "Soccer",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strLeagueBadge": "https://r2.thesportsdb.com/images/media/league/badge/dqo6r91549878326.png",
+      "strSeason": "2026",
+      "strDescriptionEN": null,
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "Atlanta United",
+      "intHomeScore": null,
+      "intRound": "9",
+      "intAwayScore": null,
+      "intSpectators": null,
+      "strOfficial": "",
+      "dateEvent": "2026-04-25",
+      "dateEventLocal": null,
+      "strTime": "17:00:00",
+      "strTimeLocal": null,
+      "strGroup": null,
+      "idHomeTeam": "134148",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "idAwayTeam": "135851",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/ej091x1602103070.png",
+      "intScore": null,
+      "intScoreVotes": null,
+      "strResult": null,
+      "idVenue": "16782",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strCity": null,
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/0d1mu81674489091.jpg",
+      "strSquare": "https://r2.thesportsdb.com/images/media/event/square/1i0wk21706713736.jpg",
+      "strFanart": null,
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/lh56x71706713125.jpg",
+      "strBanner": "https://r2.thesportsdb.com/images/media/event/banner/349xhb1706718535.jpg",
+      "strMap": null,
+      "strTweet1": null,
+      "strVideo": null,
+      "strStatus": "Not Started",
+      "strPostponed": "no",
+      "strLocked": "unlocked"
+    },
+    {
+      "idEvent": "2406865",
+      "idAPIfootball": "1490252",
+      "strTimestamp": "2026-05-02T17:00:00",
+      "strEvent": "Toronto FC vs San Jose Earthquakes",
+      "strEventAlternate": "San Jose Earthquakes @ Toronto FC",
+      "strFilename": "American Major League Soccer 2026-05-02 Toronto FC vs San Jose Earthquakes",
+      "strSport": "Soccer",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strLeagueBadge": "https://r2.thesportsdb.com/images/media/league/badge/dqo6r91549878326.png",
+      "strSeason": "2026",
+      "strDescriptionEN": null,
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "San Jose Earthquakes",
+      "intHomeScore": null,
+      "intRound": "10",
+      "intAwayScore": null,
+      "intSpectators": null,
+      "strOfficial": "",
+      "dateEvent": "2026-05-02",
+      "dateEventLocal": null,
+      "strTime": "17:00:00",
+      "strTimeLocal": null,
+      "strGroup": null,
+      "idHomeTeam": "134148",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "idAwayTeam": "134157",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/xyrqqt1420781048.png",
+      "intScore": null,
+      "intScoreVotes": null,
+      "strResult": null,
+      "idVenue": "16782",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strCity": null,
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/epsk7c1659976798.jpg",
+      "strSquare": "https://r2.thesportsdb.com/images/media/event/square/3x100g1659980618.jpg",
+      "strFanart": null,
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/fqaaht1644524215.jpg",
+      "strBanner": "https://r2.thesportsdb.com/images/media/event/banner/mu24rs1659979032.jpg",
+      "strMap": null,
+      "strTweet1": null,
+      "strVideo": null,
+      "strStatus": "Not Started",
+      "strPostponed": "no",
+      "strLocked": "unlocked"
+    },
+    {
+      "idEvent": "2406878",
+      "idAPIfootball": "1490267",
+      "strTimestamp": "2026-05-09T17:00:00",
+      "strEvent": "Toronto FC vs Inter Miami",
+      "strEventAlternate": "Inter Miami @ Toronto FC",
+      "strFilename": "American Major League Soccer 2026-05-09 Toronto FC vs Inter Miami",
+      "strSport": "Soccer",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strLeagueBadge": "https://r2.thesportsdb.com/images/media/league/badge/dqo6r91549878326.png",
+      "strSeason": "2026",
+      "strDescriptionEN": null,
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "Inter Miami",
+      "intHomeScore": null,
+      "intRound": "11",
+      "intAwayScore": null,
+      "intSpectators": null,
+      "strOfficial": "",
+      "dateEvent": "2026-05-09",
+      "dateEventLocal": null,
+      "strTime": "17:00:00",
+      "strTimeLocal": null,
+      "strGroup": null,
+      "idHomeTeam": "134148",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "idAwayTeam": "137699",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/m4it3e1602103647.png",
+      "intScore": null,
+      "intScoreVotes": null,
+      "strResult": null,
+      "idVenue": "16782",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strCity": null,
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/yg9alq1706716044.jpg",
+      "strSquare": "https://r2.thesportsdb.com/images/media/event/square/2p6ac91706714071.jpg",
+      "strFanart": null,
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/jqdmuw1706713416.jpg",
+      "strBanner": "https://r2.thesportsdb.com/images/media/event/banner/jaqgyc1706718698.jpg",
+      "strMap": null,
+      "strTweet1": null,
+      "strVideo": null,
+      "strStatus": "Not Started",
+      "strPostponed": "no",
+      "strLocked": "unlocked"
+    },
+    {
+      "idEvent": "2406900",
+      "idAPIfootball": "1490298",
+      "strTimestamp": "2026-05-16T23:30:00",
+      "strEvent": "Charlotte FC vs Toronto FC",
+      "strEventAlternate": "Toronto FC @ Charlotte FC",
+      "strFilename": "American Major League Soccer 2026-05-16 Charlotte FC vs Toronto FC",
+      "strSport": "Soccer",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strLeagueBadge": "https://r2.thesportsdb.com/images/media/league/badge/dqo6r91549878326.png",
+      "strSeason": "2026",
+      "strDescriptionEN": null,
+      "strHomeTeam": "Charlotte FC",
+      "strAwayTeam": "Toronto FC",
+      "intHomeScore": null,
+      "intRound": "12",
+      "intAwayScore": null,
+      "intSpectators": null,
+      "strOfficial": "",
+      "dateEvent": "2026-05-16",
+      "dateEventLocal": null,
+      "strTime": "23:30:00",
+      "strTimeLocal": null,
+      "strGroup": null,
+      "idHomeTeam": "140078",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/b6p4uz1595434047.png",
+      "idAwayTeam": "134148",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "intScore": null,
+      "intScoreVotes": null,
+      "strResult": null,
+      "idVenue": "18776",
+      "strVenue": "Bank of America Stadium",
+      "strCountry": "United States",
+      "strCity": null,
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/dekc1y1674489274.jpg",
+      "strSquare": "https://r2.thesportsdb.com/images/media/event/square/21yoe01706713753.jpg",
+      "strFanart": null,
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/1n0kgw1706713151.jpg",
+      "strBanner": "https://r2.thesportsdb.com/images/media/event/banner/q1vueq1706718550.jpg",
+      "strMap": null,
+      "strTweet1": null,
+      "strVideo": null,
+      "strStatus": "Not Started",
+      "strPostponed": "no",
+      "strLocked": "unlocked"
+    }
+  ]
+}