内容
# racehooks-mcp
MCP 服务器，用于 [RaceHooks](https://racehooks.io) — 为 AI 助手（Claude, Cursor, Windsurf）提供直接访问 RaceHooks Motorsport 分析和数据的能力。
[](https://www.npmjs.com/package/racehooks-mcp)
[](LICENSE)
> RaceHooks 是一个独立服务，与 Formula One Management 或 FIA 无关。“Formula 1”、“F1”及相关标志是 Formula One Licensing BV 的商标。
## 功能描述
将您的 [RaceHooks](https://racehooks.io) 账户暴露为一组 AI 助手可以调用的工具和资源：
**工具（动作）：**
- `list_feeds` / `list_webhooks` / `get_webhook` / `create_webhook` / `delete_webhook`
- `test_webhook` / `get_webhook_logs`
- `get_live_session` / `list_events`
- `get_subscription` / `get_usage` / `get_usage_by_feed` / `get_billing_plan`
- `start_simulation` / `list_simulations` / `get_simulation` / `cancel_simulation`
**资源（只读上下文）：**
- `racehooks://feeds` — 完整的 [feed 目录](https://racehooks.io/docs/feeds)
- `racehooks://live` — 当前实时会话状态
- `racehooks://webhooks` — 所有 webhook 订阅
- `racehooks://usage` — 当前交付使用情况
**提示（引导工作流）：**
- `setup_race_event_webhook` — 创建 events.race 订阅并设置过滤器
- `setup_fantasy_scoring_webhook` — 创建优化幻想得分的订阅
- `check_account_health` — 完整的账户健康状况总结
## 安装
```bash
npm install -g racehooks-mcp
```
或直接使用 npx 运行：
```bash
npx racehooks-mcp
```
在 [racehooks.io](https://racehooks.io) 获取您的 API 凭证。
## 配置
在启动前设置两个环境变量：
```bash
export RACEHOOKS_CLIENT_ID="your-client-id"
export RACEHOOKS_CLIENT_SECRET="your-client-secret"
# 可选 — 默认值为 https://api.racehooks.io
export RACEHOOKS_BASE_URL="https://api.racehooks.io"
```
## Claude 桌面版
添加到 `~/Library/Application Support/Claude/claude_desktop_config.json`：
```json
{
"mcpServers": {
"racehooks": {
"command": "npx",
"args": ["-y", "racehooks-mcp"],
"env": {
"RACEHOOKS_CLIENT_ID": "your-client-id",
"RACEHOOKS_CLIENT_SECRET": "your-client-secret"
}
}
}
}
```
## Claude 代码（项目配置）
添加到项目中的 `.claude/settings.json`：
```json
{
"mcpServers": {
"racehooks": {
"type": "stdio",
"command": "racehooks-mcp",
"env": {
"RACEHOOKS_CLIENT_ID": "your-client-id",
"RACEHOOKS_CLIENT_SECRET": "your-client-secret"
}
}
}
}
```
或使用 npx（无需全局安装）：
```json
{
"mcpServers": {
"racehooks": {
"type": "stdio",
"command": "npx",
"args": ["-y", "racehooks-mcp"],
"env": {
"RACEHOOKS_CLIENT_ID": "your-client-id",
"RACEHOOKS_CLIENT_SECRET": "your-client-secret"
}
}
}
}
```
## Cursor / Windsurf
添加到您的 MCP 配置文件（`.cursor/mcp.json` 或等效文件）：
```json
{
"mcpServers": {
"racehooks": {
"command": "npx",
"args": ["-y", "racehooks-mcp"],
"env": {
"RACEHOOKS_CLIENT_ID": "your-client-id",
"RACEHOOKS_CLIENT_SECRET": "your-client-secret"
}
}
}
}
```
## 示例用法与 Claude
配置完成后，您可以向 Claude 提问：
> "检查我的 RaceHooks 账户健康状况"
> "为 https://myapp.com/hook 创建一个 events.race webhook，过滤仅限法拉利"
> "以 10 倍速度启动 2025 年 Monaco GP 排位赛模拟，对比我的 webhook"
> "显示今天哪些 feeds 使用的交付配额最多"
> "为我的 VER、NOR、LEC 车队在 https://scoring.myapp.com/hook 设置一个幻想计分 webhook"
## 安全
MCP 服务器作为本地 stdio 进程运行 — 它从不绑定网络端口。您的凭证通过环境变量传递，不包含在工具调用或资源 URI 中。
所有 API 调用都使用 OAuth 2 客户端凭证进行身份验证（令牌在过期前自动刷新）。
## 链接
- [RaceHooks 控制台](https://racehooks.io/console) — 注册和管理您的账户
- [RaceHooks API 文档](https://racehooks.io/docs)
- [Webhook API 参考](https://racehooks.io/docs/webhooks)
- [Feed 目录](https://racehooks.io/docs/feeds)
- [GitHub](https://github.com/racehooks/racehooks-mcp)
- [npm](https://www.npmjs.com/package/racehooks-mcp)
- [Smithery 列表](https://smithery.ai/server/racehooks-mcp)
- [MCP 规范](https://modelcontextprotocol.io)
