FirstCycling MCP 서버

FirstCycling의 전문 사이클링 데이터를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 프로 사이클 선수, 경기 결과, 경기 세부 정보, 그리고 과거 사이클링 데이터에 대한 포괄적인 정보를 검색할 수 있습니다.

특징

이 MCP 서버는 전문적인 사이클링 데이터에 대한 풍부한 액세스를 제공하며 다음과 같은 도구를 제공합니다.

프로 사이클 선수에 대한 정보 찾기
경주 결과 및 세부 정보 검색
과거 레이스 데이터 탐색
라이더 성과 및 경력 진행 분석
자전거 팀 및 대회에 대한 정보 접근

실제 사용 사례

이 MCP 서버를 사용하면 Claude를 사용하여 다음을 수행할 수 있습니다.

라이더 분석

성과 추적 : "타데이 포가차르는 지난 몇 년 동안 투르 드 프랑스에서 어떤 성과를 거두었나요?"
경력 진행 : "Wout van Aert의 팀 역사와 경력 진행 상황을 보여주세요."
특수화 분석 : "Monument classics에서 Mathieu van der Poel의 성과는 무엇인가?"
승리 분석 : "요나스 빈게고르의 월드투어 승리를 모두 나열하세요."
역사적 비교 : "Primož Roglič와 Jonas Vingegaard의 그랜드 투어 결과를 비교하십시오."

인종 연구

최근 결과 : "2023년 파리-루베의 결과를 보여주세요."
역사적 맥락 : "플랜더스 투어에서 가장 어린 우승자와 가장 나이 많은 우승자는 누구입니까?"
팀 분석 : "자세한 팀 정보와 함께 2023년 투르 드 프랑스의 출발 목록을 확인하세요."
레이스 통계 : "리에주-바스토뉴-리에주의 우승 기록을 보여주세요. 누가 가장 많이 우승했습니까?"
스테이지 정보 : "2023년 지로 디탈리아의 스테이지 프로필을 보여 주시겠습니까?"

스포츠 저널리즘

"사이클링 잡지 기사에 렘코 에베네포엘의 자세한 프로필을 작성하세요."
"타데이 포가차르와 요나스 빈게고르 등 최고 경쟁자들의 최근 결과를 바탕으로 다가올 투르 드 프랑스에 대한 미리보기를 작성하세요."
"톰 피드콕의 레이스 결과와 팀 역사를 바탕으로 그의 경력 변화를 분석하세요."

자전거 교육

"역사와 수상자에 대한 데이터를 사용하여 Monument 클래식을 특별하게 만드는 요소를 설명하세요."
"그랜드 투어와 프로 사이클링에서의 중요성에 대한 교육적 요약을 작성하세요."
"데이터에서 추출한 예를 사용하여 프로 자전거 선수의 일반적인 경력 진행 과정을 설명하세요."

요구 사항

Python 3.10 이상
uv 패키지 관리자(추천)
pyproject.toml 에 나열된 종속성은 다음과 같습니다.
- 엠씨피
- 아름다운수프4
- lxml
- 팬더
- 무기력 상태
- 웹 스크래핑 및 데이터 처리를 위한 기타 패키지

설정

이 저장소를 복제하세요
가상 환경을 만들고 활성화하세요.지엑스피1
종속성 설치:
uv pip install -e .

FirstCycling API

이 서버는 프로젝트에 직접 통합된 FirstCycling API를 사용합니다. 이 API는 웹 스크래핑을 통해 FirstCycling 웹사이트에서 데이터를 가져오는 방법을 제공합니다.

MCP 도구

서버는 모델 컨텍스트 프로토콜을 통해 다음 도구를 제공합니다.

라이더 정보

도구	설명
`get_rider_info`	국적, 생년월일, 체중, 키, 현재 팀을 포함한 라이더의 기본적인 전기 정보를 얻으세요.
`get_rider_best_results`	중요도 순으로 정렬된 라이더의 최고 경력 결과를 검색합니다.
`get_rider_grand_tour_results`	그랑 투르(투르 드 프랑스, 지로 디탈리아, 부엘타 아 에스파냐) 라이더의 결과를 확인하세요
`get_rider_monument_results`	자전거의 Monument classics에서 라이더의 결과를 검색하세요
`get_rider_team_and_ranking`	라이더의 팀 이력과 시간 경과에 따른 UCI 랭킹 추이를 알아보세요.
`get_rider_race_history`	라이더의 전체 레이스 참가 기록을 검색합니다(연도별로 필터링 가능).
`get_rider_one_day_races`	1일 경주에서 라이더의 결과를 얻으세요. 연도별로 필터링할 수도 있습니다.
`get_rider_stage_races`	연도별로 필터링하여 여러 날에 걸친 단계 경주에서 라이더의 결과를 확인하세요.
`get_rider_teams`	라이더의 경력 전반에 걸친 전체 팀 기록을 검색합니다.
`get_rider_victories`	WorldTour 또는 UCI 레이스에 대한 선택적 필터가 포함된 라이더의 경력 승리 목록을 받으세요.

레이스 정보

도구	설명
`get_race_results`	레이스 ID 및 연도별로 특정 레이스 에디션에 대한 결과를 검색합니다.
`get_race_overview`	역사, 기록, 과거 우승자를 포함한 경주에 대한 일반 정보를 얻으세요
`get_race_stage_profiles`	다단계 레이스에 대한 단계 프로필 및 세부 정보 검색
`get_race_startlist`	세부적이거나 기본적인 팀 정보가 포함된 특정 레이스 에디션의 시작 목록을 받으세요
`get_race_victory_table`	가장 많은 승리를 거둔 라이더를 보여주는 경주의 역대 승리 표를 검색합니다.
`get_race_year_by_year`	선택적인 분류 필터를 사용하여 경주에 대한 연도별 결과를 얻으세요
`get_race_youngest_oldest_winners`	경주에서 가장 어린 우승자와 가장 나이 많은 우승자에 대한 정보를 검색합니다.
`get_race_stage_victories`	다단계 경주에서 단계 승리에 대한 정보를 얻으세요

검색 도구

도구	설명
`search_rider`	라이더를 이름으로 검색하고, 라이더의 ID와 기본 정보를 반환합니다.
`search_race`	이름으로 레이스를 검색하고 해당 레이스의 ID와 기본 정보를 반환합니다.

용법

개발 모드

다음을 실행하여 MCP Inspector로 서버를 테스트할 수 있습니다.

uv run mcp dev firstcycling.py

이렇게 하면 서버가 시작되고 브라우저에서 MCP 검사기가 열려 사용 가능한 도구를 테스트할 수 있습니다.

데스크톱용 Claude와 통합

이 서버를 Claude for Desktop과 통합하려면:

다음 위치에 있는 Claude for Desktop 구성 파일을 편집하세요.
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
구성에 서버를 추가합니다.
{ "mcpServers": { "firstcycling": { "command": "uv", "args": ["--directory", "/path/to/server/directory", "run", "firstcycling.py"] } } }
데스크톱용 Claude를 다시 시작하세요

특허

MIT

FirstCycling MCP Server

Integrations