Formula 1 MCP Server

项目简介

Formula 1 MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 客户端提供 Formula 1 (F1) 赛事数据。它通过标准化的 MCP 协议，将实时的和历史的 F1 赛车数据以易于访问和利用的方式提供给 LLM 应用，从而增强 LLM 在 F1 相关场景下的理解和应用能力。

主要功能点

资源访问 (Resources): 通过标准化的 URI 访问 F1 赛事数据，包括：
- 实时遥测数据
- 历史比赛信息
- 车手和车队积分榜
- 天气数据
- 赛道信息
工具 (Tools): 注册并提供一系列功能强大的工具，允许 LLM 客户端调用以获取特定 F1 数据，例如：
- 获取实时比赛数据 (如 'getLiveTimingData')
- 查询车手信息 (如 'getDriverInfo')
- 获取历史比赛结果 (如 'getHistoricRaceResults')
- 查询天气数据 (如 'getWeatherData')
- 获取车队无线电通讯 (如 'getTeamRadio')
- 等等，具体工具列表请参考README.md 文件 "Functions" 部分。

安装步骤

获取代码:

git clone https://github.com/Panth1823/formula1-mcp
cd formula1-mcp

安装依赖:
```
npm install
```
构建服务器:
```
npm run build
```

服务器配置

要将 Formula 1 MCP Server 集成到 MCP 客户端（如 Cursor 或 Claude Desktop），您需要配置客户端以连接到此服务器。以下是配置示例，请根据您的 MCP 客户端类型选择相应的配置文件进行配置。请务必将 '<path-to-your-cloned-repo>' 替换为克隆仓库的绝对路径。

配置示例 (JSON 格式):

{
  "mcpServers": {
    "formula1": {
      "command": "node",
      "args": ["<path-to-your-cloned-repo>/build/index.js"],
      "cwd": "<path-to-your-cloned-repo>",
      "enabled": true
    }
  }
}

配置参数说明:

'server name': 'formula1' (服务器名称，客户端内唯一标识即可)
'command': 'node' (启动服务器的命令，这里使用 Node.js 运行时)
'args': '["<path-to-your-cloned-repo>/build/index.js"]' (传递给 'command' 的参数，指向编译后的服务器入口文件)
'cwd': '"<path-to-your-cloned-repo>"' (服务器的工作目录，设置为仓库根目录)
'enabled': 'true' (设置为 'true' 启用该服务器)

不同 MCP 客户端的配置文件路径示例:

Cursor:
- Windows: '%APPDATA%.cursor\mcp.json'
- MacOS: '~/.cursor/mcp.json'
- Linux: '~/.config/.cursor/mcp.json'
Claude Desktop:
- Windows: '%APPDATA%\Claude\claude_desktop_config.json'
- MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'

基本使用方法

配置完成后，您的 MCP 客户端应该能够检测到 Formula 1 MCP Server。您可以通过客户端的功能（通常是工具调用或自定义命令）来使用服务器提供的工具。

例如，在支持自然语言工具调用的客户端中，您可以指示 LLM 调用 'getLiveTimingData' 工具来获取实时比赛数据，或者使用 'getDriverInfo' 工具查询特定车手的信息。

具体的工具名称和参数请参考仓库 README.md 文件 "Functions" 部分，以及 'src/index.ts' 文件中 'server.tool()' 的定义。

关键词