{"id":28914811,"url":"https://github.com/maxbleu/mcp-f1data","last_synced_at":"2026-04-29T09:03:17.554Z","repository":{"id":300300432,"uuid":"1005825544","full_name":"Maxbleu/mcp-f1data","owner":"Maxbleu","description":"MCP server for F1 data using Fastf1, OpenF1 or Ergast APIs","archived":false,"fork":false,"pushed_at":"2025-06-20T22:57:01.000Z","size":878,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-06-20T23:31:07.125Z","etag":null,"topics":["ai","ergast-api","fastf1","jopilca","mcp","mcp-server","modelcontextprotocol"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Maxbleu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-20T22:27:25.000Z","updated_at":"2025-06-20T23:00:32.000Z","dependencies_parsed_at":"2025-06-20T23:41:11.308Z","dependency_job_id":null,"html_url":"https://github.com/Maxbleu/mcp-f1data","commit_stats":null,"previous_names":["maxbleu/mcp-f1data"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/Maxbleu/mcp-f1data","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maxbleu%2Fmcp-f1data","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maxbleu%2Fmcp-f1data/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maxbleu%2Fmcp-f1data/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maxbleu%2Fmcp-f1data/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Maxbleu","download_url":"https://codeload.github.com/Maxbleu/mcp-f1data/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maxbleu%2Fmcp-f1data/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261200706,"owners_count":23123958,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ergast-api","fastf1","jopilca","mcp","mcp-server","modelcontextprotocol"],"created_at":"2025-06-21T22:08:45.774Z","updated_at":"2026-04-29T09:03:17.536Z","avatar_url":"https://github.com/Maxbleu.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🏎️ MCP Server F1Data\r\n\r\n\u003cimg src=\"./content/example.gif\" width=\"1000\"\u003e\r\n\r\nA Model Context Protocol (MCP) server for interacting with F1Data through LLM interfaces like Claude. **You will need to have Claude installed on your system to continue.**\r\n\r\n## Getting Started\r\nFirst of all, you need to install `mcp-f1data` package from pypi with pip, using the following command:\r\n```commandline\r\npip install mcp-f1data\r\n```\r\n\r\nTo use `mcp-f1data` server in claude can be configured by adding the following to your configuration file.\r\n- Windows: `%APPDATA%/Claude/claude_desktop_config.json`\r\n- Linux: `~/Library/Application Support/Claude/claude_desktop_config.json`\r\n\r\nAdd the F1Data MCP server configuration:\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"mcp-f1data\": {\r\n        \"command\": \"python\",\r\n        \"args\": [ \"-m\", \"mcp-f1data\" ]\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n## Tools \r\n- `circuit`\r\n- `constructor`\r\n- `driver`\r\n- `grand prix`\r\n- `manufacturer`\r\n- `race`\r\n- `season`\r\n\r\n## Instalation\r\nActive the virtual environment and install the requirements using:\r\n```commandline\r\n.\\.venv\\Scripts\\activate\r\n```\r\n\r\nInstall the mcp server in Claude using the following command:\r\n```commandline\r\nmcp install .\\server.py\r\n```\r\n\r\n## Requirements\r\nThe requirementes used to build this MCP server are:\r\n- `fastf1`\r\n- `pandas`\r\n- `fastmcp`\r\n- `websockets`\r\n- `mcp`\r\n- `pydantic`\r\n- `fastapi`\r\n\r\n## Testing \r\nYou can test the server using the MCP Inspector:\r\n```commandline\r\nmcp dev .\\server.py\r\n```\r\n\r\n## 📜 Licenses\r\n\r\n### Source Code\r\nThe source code of this project is licensed under the [Apache License 2.0](./LICENSE).\r\n\r\n### Data\r\nThis project uses Formula 1 data from [**F1DB**](https://github.com/f1db/f1db) \r\ncreated by the F1DB contributors, licensed under the \r\n[Creative Commons Attribution 4.0 International (CC BY 4.0)](https://creativecommons.org/licenses/by/4.0/) license.\r\n\r\nThe original data has been:\r\n- Imported and structured into a PostgreSQL database\r\n- Exposed through a custom MCP\r\n- Optimized for efficient querying\r\n\r\nThe original data is provided \"as-is\" without warranties of any kind, \r\nas per the terms of the CC BY 4.0 license.\r\n\r\nFor complete attribution details, see [ATTRIBUTIONS.md](./ATTRIBUTIONS.md)..\r\n\r\n## Notice\r\n\r\nMCPF1Data is unofficial and are not associated in any way with the Formula 1 companies. F1, FORMULA ONE, FORMULA 1, FIA FORMULA ONE WORLD CHAMPIONSHIP, GRAND PRIX and related marks are trade marks of Formula One Licensing B.V.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaxbleu%2Fmcp-f1data","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaxbleu%2Fmcp-f1data","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaxbleu%2Fmcp-f1data/lists"}