obinopaul/soccer-mcp-server

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

7 stars 5 forks 품질 54 트렌드 15

A Python server implementing Model Context Protocol (MCP) for football (soccer) statistics and live match data using the API-Football service.

개요

A Python server implementing Model Context Protocol (MCP) for football (soccer) statistics and live match data using the API-Football service. This server provides a comprehensive set of tools for accessing football data through the API-Football API. It serves as a bridge between applications and football data services, offering both live match information and historical statistics for leagues, teams, and players worldwide. - League data (standings, fixtures, schedules) - Team information and fixtures - Player statistics and profiles - Live match data (events, statistics, timelines) - Match analysis (statistics, events) This server requires an API key from RapidAPI for the API-Football service: 1. Create an account on RapidAPI 2. Subscribe to the API-Football API 3.

README

원문 README의 일부입니다. 원문 보기.

Soccer MCP Server

A Python server implementing Model Context Protocol (MCP) for football (soccer) statistics and live match data using the API-Football service.

Overview

This server provides a comprehensive set of tools for accessing football data through the API-Football API. It serves as a bridge between applications and football data services, offering both live match information and historical statistics for leagues, teams, and players worldwide.

Features

League data (standings, fixtures, schedules)
Team information and fixtures
Player statistics and profiles
Live match data (events, statistics, timelines)
Match analysis (statistics, events)

Configuration

This server requires an API key from RapidAPI for the API-Football service:

Create an account on RapidAPI
Subscribe to the API-Football API

Set the environment variable:

RAPID_API_KEY_FOOTBALL=your_api_key_here

Tools

League Data

get_league_id_by_name
- Retrieve the league ID for a given league name
- Example: get_league_id_by_name(league_name="Premier League")
get_all_leagues_id
- Retrieve a list of all football leagues with IDs
- Can be filtered by country
- Example: get_all_leagues_id(country=["England", "Spain"])
get_standings
- Retrieve league standings for multiple leagues and seasons
- Can be filtered by team
- Example: get_standings(league_id=[39, 140], season=[2022, 2023])
get_league_info
- Retrieve information about a specific football league
- Example: get_league_info(league_name="Champions League")
get_league_fixtures
- Retrieves all fixtures for a given league and season
- Example: get_league_fixtures(league_id=39, season=2023)
get_league_schedule_by_date
- Retrieves the schedule for a league on specified dates
- Example: get_league_schedule_by_date(league_name="Premier League", date=["2024-03-08", "2024-03-09"], season="2023")

Player Data

get_player_id
- Retrieve player IDs and information for players matching a name
- Example: get_player_id(player_name="Messi")
get_player_profile
- Retrieve a player’s profile by their last name
- Example: get_player_profile(player_name="Messi")
get_player_statistics
- Retrieve detailed player statistics by seasons and league name
- Example: get_player_statistics(player_id=154, seasons=[2022, 2023], league_name="La Liga")
get_player_statistics_2
- Retrieve detailed player statistics by seasons and league ID
- Example: get_player_statistics_2(player_id=154, seasons=[2022, 2023], league_id=140)

Team Data

get_team_fixtures
- Returns past or upcoming fixtures for a team

GitHub에서 전체 README 보기

설치

docker exec -i soccer_server python soccer_server.py

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "soccer_server": {
      "command": "docker",
      "args": [
        "exec",
        "-i",
        "soccer_server",
        "python",
        "soccer_server.py"
      ],
      "env": {
        "RAPID_API_KEY_FOOTBALL": "your_api_key_here"
      }
    }
  }
}