Tba MCP Server

🚀 藍色聯盟MCP服務器

這是一個模型上下文協議（MCP）服務器，它提供對藍色聯盟（The Blue Alliance）API的訪問，用於獲取FIRST機器人競賽數據。該服務器使AI助手和其他MCP客戶端能夠檢索全面的FRC團隊、賽事和比賽信息。

✨ 主要特性

• 團隊信息：獲取詳細的團隊資料、參賽歷史、獲獎情況和媒體信息。
• 賽事數據：訪問賽事詳情、排名、比賽和淘汰賽聯盟信息。
• 比賽結果：檢索包含得分、聯盟和比賽分析的比賽數據。
• 歷史數據：查詢1992年至今的數據。
• 類型安全：所有響應都通過Zod模式進行驗證。
• 全面覆蓋：35+種工具涵蓋了藍色聯盟API的所有主要端點。

📦 安裝指南

從npm安裝

npm install -g @withinfocus/tba-mcp-server

從源代碼安裝

git clone https://github.com/withinfocus/tba-mcp-server.git
cd tba-mcp-server
npm ci
npm run build

🔧 配置

將你的藍色聯盟API密鑰設置為環境變量：

export TBA_API_KEY=your_api_key_here

或者創建一個 .env 文件：

TBA_API_KEY=your_api_key_here

💻 使用示例

基礎用法

將其添加到你的MCP客戶端配置中（例如Claude Desktop）：

{
  "mcpServers": {
    "tba": {
      "command": "npx",
      "args": ["-y", "@withinfocus/tba-mcp-server"],
      "env": {
        "TBA_API_KEY": "your_api_key_here"
      }
    }
  }
}

高級用法

獲取團隊信息

// 獲取詳細的團隊資料
get_team(team_key: "frc86")

// 獲取團隊在某一年的賽事信息
get_team_events(team_key: "frc86", year: 2024)

// 獲取團隊的獲獎情況
get_team_awards(team_key: "frc86", year: 2024)

分析賽事

// 獲取賽事詳情
get_event(event_key: "2024casj")

// 獲取參賽團隊
get_event_teams(event_key: "2024casj")

// 獲取排名
get_event_rankings(event_key: "2024casj")

// 獲取淘汰賽聯盟
get_event_alliances(event_key: "2024casj")

獲取比賽數據

// 獲取詳細的比賽信息
get_match(match_key: "2024casj_qm1")

// 獲取機器人跟蹤數據（如果可用）
get_match_zebra(match_key: "2024casj_qm1")

📚 詳細文檔

可用工具

團隊信息（24種工具）

訪問全面的團隊數據，包括資料、參賽歷史、賽事、比賽、獲獎情況和媒體信息。 關鍵工具：get_team、get_team_events、get_team_matches、get_team_awards、get_team_media 查看所有團隊工具 →

賽事信息（19種工具）

查詢賽事詳情、參賽隊伍、排名、比賽和分析數據。 關鍵工具：get_event、get_events、get_event_teams、get_event_rankings、get_event_matches、get_event_oprs 查看所有賽事工具 →

比賽信息（3種工具）

檢索詳細的比賽數據，包括得分、聯盟和機器人跟蹤信息。 關鍵工具：get_match、get_match_simple、get_match_zebra 查看所有比賽工具 →

賽區工具（8種工具）

訪問賽區排名、賽事和團隊信息。 關鍵工具：get_districts、get_district_rankings、get_district_events、get_district_teams 查看所有賽區工具 →

通用/實用工具（6種工具）

分頁團隊列表和API狀態信息。 關鍵工具：get_teams、get_teams_by_year、get_status 查看所有實用工具 →

完整文檔

• 所有工具 - 所有35+種工具的完整參考，包含參數和示例。
• 數據模式 - 所有響應類型的詳細模式文檔。
• 開發指南 - 構建、測試和貢獻的相關說明。

🔨 開發

有關以下方面的詳細說明，請參閱開發指南：

• 構建和測試
• 添加新工具
• 運行單元測試和集成測試
• 代碼標準和貢獻指南

快速開始：

npm ci                   # 安裝依賴
npm run build            # 構建TypeScript
npm test                 # 運行單元測試
npm run test:integration # 運行集成測試
npm run lint             # 檢查代碼質量
npm run inspect          # 啟動MCP檢查器

🔗 相關鏈接

• 藍色聯盟 - 官方FRC數據源
• 藍色聯盟API文檔 - 官方API文檔
• 模型上下文協議 - MCP規範
• FIRST機器人競賽 - 官方FRC網站