⚽️ Soccerdata MCP 서버

• MCP-Soccerdata는 SoccerDataAPI에 연결하여 자연어 상호작용을 통해 최신 축구 경기 정보를 제공하는 오픈 소스 모델 컨텍스트 프로토콜(MCP) 서버입니다.

• Claude Desktop과 같은 MCP 지원 클라이언트와 함께 사용하도록 설계되었으며, 사용자는 대규모 언어 모델(LLM)을 활용하여 축구 데이터를 검색할 수 있습니다.

✨ 특징

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

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

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

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

- 경기 목록 및 기본 정보

• 현재 활성화된 모든 경기의 글로벌 목록

• 홈팀과 원정팀 이름

• 경기 시작 시간 및 경기 날짜

• 경기장 세부 정보

• 현재 점수

- 경기 세부 정보

• 경기 상태: 예약됨, 진행 중 또는 완료

• 골 분석: 전반전, 후반전, 연장전, 승부차기

• 최종 결과: 승리, 무승부 또는 패배

- 키매치 이벤트

• 골 이벤트(누가 득점했는지, 언제, 어떻게 득점했는지)

• 대체

• 옐로카드와 레드카드

• 페널티

- 팀 라인업

• 선발 11인

• 벤치 선수들

• 부상 상태

• 팀 구성

- 배당률 및 베팅 정보

• 승/무/패 배당률

• 오버/언더 배당률

• 핸디캡 베팅 배당률

- 리그 메타데이터

• 리그 이름

• 국가

• 경쟁 형식(예: 정규 시즌, 녹아웃 단계)

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

Related MCP server: HackathonWatch MCP Server

🎥 데모

🚀 빠른 시작

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 라이선스 에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.

• 모델 컨텍스트 프로토콜 로 구축됨