MCP-사커데이터

⚽️ Soccerdata MCP 서버

MCP-Soccerdata는 SoccerDataAPI에 연결하여 자연어 상호작용을 통해 최신 축구 경기 정보를 제공하는 오픈 소스 모델 컨텍스트 프로토콜(MCP) 서버입니다.
Claude Desktop과 같은 MCP 지원 클라이언트와 함께 사용하도록 설계되었으며, 사용자는 대규모 언어 모델(LLM)을 활용하여 축구 데이터를 검색할 수 있습니다.

✨ 특징

🏟️ 라이브 축구 경기 통찰력

MCP-Soccerdata는 전 세계에서 진행 중인 축구 경기에 대한 실시간 정보를 제공하는 데 중점을 두고 있습니다.

"지금 어떤 축구 경기가 진행되고 있나요?"
"오늘 PSG 대 애스턴 빌라의 예상 라인업은 무엇인가요?"
"최근 축구 경기의 점수와 골수를 알려주세요."

→ 아래에 설명된 세부 카테고리를 포함하여 구조화된 형식으로 관련 축구 데이터를 제공합니다.

- 경기 목록 및 기본 정보

현재 활성화된 모든 경기의 글로벌 목록
홈팀과 원정팀 이름
경기 시작 시간 및 경기 날짜
경기장 세부 정보
현재 점수

- 경기 세부 정보

경기 상태: 예약됨, 진행 중 또는 완료
골 분석: 전반전, 후반전, 연장전, 승부차기
최종 결과: 승리, 무승부 또는 패배

- 키매치 이벤트

골 이벤트(누가 득점했는지, 언제, 어떻게 득점했는지)
대체
옐로카드와 레드카드
페널티

- 팀 라인업

선발 11인
벤치 선수들
부상 상태
팀 구성

- 배당률 및 베팅 정보

승/무/패 배당률
오버/언더 배당률
핸디캡 베팅 배당률

- 리그 메타데이터

리그 이름
국가
경쟁 형식(예: 정규 시즌, 녹아웃 단계)

⚠️ 라이브 , 예정된 경기, 최근 완료된 경기에만 집중

🎥 데모

🚀 빠른 시작

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 Amadeus MCP 서버를 자동으로 설치하려면:

지엑스피1

필수 조건

파이썬 3.12+
uv 패키지 관리자
Soccerdata API 계정
MCP 호환 클라이언트(예: 데스크톱용 Claude)

1. 복제 및 설정

저장소를 복제합니다

git clone https://github.com/yeonupark/mcp-soccer-data.git
cd mcp-soccer-data

종속성 설치

uv sync

2. API 키 가져오기 및 환경 설정

자격 증명을 사용하여 .env 파일을 만듭니다.

AUTH_KEY=your_auth_key

https://soccerdataapi.com/ 에 가입하여 인증 키를 받으세요.

3. MCP 클라이언트 구성

MCP 클라이언트(예: 데스크톱용 Claude)에 이 서버를 등록합니다.

~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
      "mcp-soccer-data": {
          "command": "/ABSOLUTE/PATH/TO/PARENT/FOLDER/uv",
          "args": [
              "--directory",
              "/ABSOLUTE/PATH/TO/PARENT/FOLDER/src/",
              "run",
              "--env-file",
              "/ABSOLUTE/PATH/TO/PARENT/FOLDER/.env",
              "server.py"
          ]
      }
  }
}

🛠️ 도구

다음 도구는 MCP 클라이언트에 노출됩니다.

`get_livescores()`

-> 전 세계에서 진행 중인 축구 경기에 대한 실시간 정보를 제공합니다.

📝 라이센스

이 프로젝트는 MIT 라이선스 에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.
모델 컨텍스트 프로토콜 로 구축됨