대학 풋볼 데이터 MCP 서버

Claude Desktop 내의 College Football Data API 에서 얻은 대학 축구 통계에 대한 액세스를 제공하는 MCP 서버 구현입니다.

개요

이 모델 컨텍스트 프로토콜(MCP) 서버를 통해 AI 어시스턴트와 애플리케이션은 다음을 수행할 수 있습니다.

종합적인 대학 축구 통계 및 데이터 쿼리
경기 결과, 팀 기록 및 선수 통계에 액세스하세요
경기별 데이터 분석 및 요약 작성
순위와 승리 확률 지표 보기
팀 성과를 비교하고 통찰력을 얻으세요

사용자는 자연어를 사용하여 쿼리를 실행할 수 있습니다.

샘플 출력

Q. 2014 시즌 FCS 경기 중 가장 큰 이변은 무엇이었나요?

A. 2014년 FCS에서 가장 큰 이변을 일으킨 경기를 찾는 데 도움을 드리겠습니다. 경기 데이터를 살펴보고, FCS 팀 간의 경기 중 팀 전력에 큰 차이가 있었고 예상치 못한 결과가 나온 경기에 초점을 맞추겠습니다.

데이터에 따르면 2014년 FCS에서 주목할 만한 이변이 여러 차례 있었지만, 그중에서도 가장 눈에 띄는 것은 2014년 9월 6일 이스턴 워싱턴이 워싱턴을 52-59로 이긴 경기였습니다. 이 경기가 특히 중요했던 이유는 다음과 같습니다.

워싱턴은 Pac-12 컨퍼런스의 FBS 팀이었습니다.
이 경기는 워싱턴의 홈구장(허스키 스타디움)에서 열렸습니다.
경기 후 통계에 따르면 동부 워싱턴의 승리 확률은 1.4%에 불과했습니다.
Eastern Washington이 득점한 59점은 Pac-12 상대팀을 상대로 FCS 팀이 기록한 역대 최다 득점이었습니다.
워싱턴은 경기 시작 전 여러 점수로 유리한 입장에 있었습니다.

그 시즌의 다른 주목할 만한 FCS 이변은 다음과 같습니다.

노스다코타주립대, 아이오와주립대 34-14로 승리
베순-쿠크먼, FIU 14-12 승리
노던 아이오와, 아이오와를 거의 이길 뻔 (31-23 패배)

그러나 다음을 고려해보면 동부 워싱턴이 워싱턴을 이긴 것이 2014 FCS 시즌에서 가장 큰 이변인 것으로 보인다.

부문별 차이(FCS 대 FBS)
FBS 상대팀(파워5 컨퍼런스)의 규모
약팀의 득점 차이와 공격력
Power 5 팀을 상대로 한 FCS 최고 득점 승리 중 하나로서 역사적 중요성
그것은 적대적인 환경의 도로에서 일어났다는 사실

필수 조건

Python 3.11 이상
UV 패키지 관리자 (권장)
대학 풋볼 데이터 API 키( 여기서 받으세요 )

설치

Smithery를 통해 설치

Smithery 를 통해 Claude Desktop용 College Football Data Server를 자동으로 설치하려면:

지엑스피1

이 저장소를 복제하세요:

git clone https://github.com/yourusername/cfbd-mcp-server
cd cfbd-mcp-server

가상 환경을 만들고 활성화하세요.

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

종속성 설치:

uv pip install -e .

프로젝트 루트에 .env 파일을 만들고 API 키를 추가하세요.

CFB_API_KEY=your_api_key_here

수동 설치

이 저장소를 복제하세요:

git clone https://github.com/yourusername/cfbd-mcp-server
cd cfbd-mcp-server

가상 환경을 만들고 활성화하세요.

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

종속성 설치:

uv pip install -e .

프로젝트 루트에 .env 파일을 만들고 API 키를 추가하세요.

CFB_API_KEY=your_api_key_here

용법

서버 실행

서버를 시작합니다:

uv run cfbd-mcp-server

Claude Desktop과 연결

Claude Desktop 구성을 다음에서 엽니다.
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
서버 구성을 추가합니다.

{
    "mcpServers": {
        "cfbd-mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "/full/path/to/cfbd-mcp-server",
                "run",
                "cfbd-mcp-server"
            ],
            "env": {
                "CFB_API_KEY": "xxx",
                "PATH": "/full/path/to/python"
            }
        }
    }
}

Claude Desktop을 닫은 후 다시 시작하세요.

재시작하면 텍스트 상자 오른쪽 하단에 작은 망치 아이콘이 표시됩니다. 아이콘 위에 마우스를 올리면 사용 가능한 MCP 도구의 개수가 표시됩니다.

설치 후 업데이트

업데이트된 파일을 다운로드하세요

cd cfbd-mcp-server
git pull

기존 패키지를 제거합니다.

uv pip uninstall cfbd-mcp-server

기존 빌드 아티팩트 및 메타데이터 삭제

Windows의 경우:

rmdir /s /q build dist
del /s /q *.egg-info

macOS의 경우:

rm -rf build dist *.egg-info

개정된 패키지와 해당 종속성을 설치합니다.

uv pip install -e .
uv sync --dev --all-extras

uv run cfbd-mcp-server

Claude Desktop을 닫고 다시 시작하세요.

특징

자원

모든 엔드포인트에 대한 스키마 문서에 액세스하세요.

schema://games - 게임 정보 및 점수
schema://records - 팀 시즌 기록
schema://games/teams - 자세한 팀 게임 데이터
schema://plays - 플레이 바이 플레이 정보
schema://drives - 드라이브 요약 및 결과
schema://play/stats - 개별 플레이 통계
schema://rankings - 여론조사에 따른 팀 순위
schema://metrics/wp/pregame - 경기 전 승리 확률
schema://game/box/advanced - 고급 박스 스코어 통계

도구

직접 엔드포인트 쿼리:

get-games - 게임 데이터 검색
get-records - 팀 기록 가져오기
get-games-teams - 팀 게임 통계에 접근
get-plays - 플레이 바이 플레이 데이터 쿼리
get-drives - 드라이브 정보 분석
get-play-stats - 플레이 통계 보기
get-rankings - 팀 순위 확인
get-pregame-win-probability - 승리 확률 보기
get-advanced-box-score - 자세한 게임 통계 및 분석에 액세스

프롬프트

미리 작성된 분석 템플릿:

analyze-game - 특정 게임에 대한 자세한 분석 얻기
analyze-team - 포괄적인 단일 팀 분석
analyze-trends - 시즌별 추세 분석
compare-teams - 두 팀의 성과를 비교합니다
analyze-rivalry - 역사적 라이벌 매치업 분석

API 제한

대학 풋볼 데이터 API는 무료로 사용할 수 있지만 속도 제한이 있습니다.

무료 계층: 분당 요청 수 제한
CFBD Patreon 구독자는 더 높은 요금 한도를 받습니다.
효율적인 쿼리 패턴을 사용하여 한계에 도달하지 않도록 합니다.
속도 제한 오류를 정상적으로 처리합니다.

개발

프로젝트 구조

cfbd-mcp-server/
├── README.md
├── pyproject.toml
└── src/
    └── cfbd_mcp_server/
        ├── .env
        ├── __init__.py
        ├── cfbd_schema.py
        ├── schema_helpers.py
        └── server.py

개발 설정

저장소를 복제합니다
개발 종속성 설치:

uv pip install -e ".[dev]"

테스트 실행:

pytest

기여하다

저장소를 포크하세요
기능 브랜치 생성
변경 사항을 커밋하세요
포크로 밀어주세요
풀 리퀘스트 제출

문제 해결

일반적인 문제

API 키 오류
- .env 및 claude_desktop_config.json 파일 모두에 API 키가 올바르게 설정되었는지 확인하세요.
- collegefootballdata.com에서 키가 유효한지 확인하세요.
속도 제한
- 가능하면 요청 간격을 넓히세요
- 더 높은 한도를 위해 Patreon 구독을 고려하세요
- 자주 액세스되는 데이터에 대한 캐싱 구현
연결 문제
- 인터넷 연결 확인
- collegefootballdata.com에서 API 상태를 확인하세요
- 코드에서 적절한 오류 처리를 보장하세요

도움 받기

GitHub에 이슈를 열어보세요
API 문서를 검토하세요
대학 풋볼 데이터 Discord를 확인하세요

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

감사의 말

API 제공을 위한 대학 축구 데이터
MCP 사양을 위한 모델 컨텍스트 프로토콜

cfbd-mcp-server

Integrations