NHL API - 모델 컨텍스트 프로토콜

모델-컨텍스트 프로토콜(MCP) 패턴을 사용하는 NHL API의 TypeScript 구현입니다. 이 MCP 서버는 팀, 선수, 순위, 일정, 통계를 포함한 NHL 데이터에 대한 액세스를 제공합니다.

개요

이 라이브러리는 모델-컨텍스트 프로토콜(MCP)을 사용하여 NHL 공식 API에 대한 깔끔한 인터페이스를 제공합니다. NHL API에서 데이터를 가져오고 MCP 도구를 통해 구조화되고 사용하기 쉬운 형식으로 제공할 수 있습니다.

📊 현재 상태

2025년 3월 10일부터 플랫폼은 다음과 같은 기능을 제공합니다.

✅ 작동 특징

1. 순위
   • 디비전별 세부 정보가 포함된 리그 전체 순위
   • 전체 팀 기록 정보
2. 팀
   • 기본 팀 ID 정보
   • 선수 세부 정보가 포함된 현재 명단 정보
   • 팀 통계(스케이터 및 골키퍼)
   • 잠재 고객 추적
3. 플레이어
   • 선수 전기 정보
   • 현재 시즌 및 경력 통계
   • 수상 인정
4. 일정
   • 현재 팀 일정
   • 날짜별 리그 일정
   • 다가오는 게임 정보
5. 통계
   • 현재 통계적 리더(스케이터 및 골키퍼)
   • 팀별 통계 분석
6. 게임 정보
   • 라이브 경기 점수 및 상태
   • 경기 일정

❌ 확인된 문제

1. 팀 정보 격차
   • 팀 조회에서 팀 부문 및 컨퍼런스 정보가 누락되었습니다.
   • 기본 팀 데이터가 불완전합니다(도시/위치 세부 정보가 없음)
2. 게임 세부 정보
   • 진행 중인 게임에 대한 제한된 게임 상태 정보
   • 플레이 바이 플레이 데이터 구현에는 추가 테스트가 필요합니다.
3. 역사적 데이터
   • 계절별 과거 데이터 접근에 검증이 필요합니다.
   • 과거 일정 검색에는 추가 테스트가 필요합니다.
4. UI 통합
   • 현재 데이터 시각화를 위한 UI 구성 요소가 없습니다.
   • 원시 데이터 형식은 프런트엔드 디스플레이를 위해 변환이 필요합니다.

📝 할 일 목록

높은 우선순위

• [ ] 전체 팀 세부 정보(부서, 컨퍼런스, 위치)를 포함하도록 팀 정보 API를 수정합니다.
• [ ] 라이브 게임에 대한 보다 자세한 게임 상태 추적을 구현합니다.
• [ ] UI 통합을 위한 데이터 변환 계층 생성
• [ ] 과거 데이터 엔드포인트의 완전한 테스트

중간 우선순위

• [ ] 표준 데이터 시각화 구성 요소 개발
• [ ] 플레이어 이미지 통합 추가
• [ ] 팀 로고/브랜드 자산 구현
• [ ] 모든 데이터 유형에 대한 검색 기능 생성

낮은 우선순위

• [ ] 자주 접근되는 데이터에 대한 캐싱 시스템 구축
• [ ] 판타지 하키 통합 포인트 추가
• [ ] 뉴스/미디어 통합 개발
• [ ] 소셜 미디어 콘텐츠 연결 추가

🚀 시작하기

1. 저장소를 복제합니다.지엑스피1
2. 종속성 설치:
   npm install
3. API 자격 증명을 구성하세요.
   cp .env.example .env # Edit .env with your API keys
4. 개발 서버를 시작합니다.
   npm run dev

🔧 API 참조

NHL-MCP 플랫폼은 다음과 같은 핵심 API 엔드포인트를 제공합니다.

팀

• get-team : 기본 팀 정보 검색
• get-team-roster : 현재 팀 명단을 가져옵니다
• get-team-stats : 팀 통계 가져오기
• get-team-prospects : 팀 유망주 정보 가져오기

플레이어

• get-player-landing : 자세한 플레이어 정보 가져오기

순위

• get-current-standings : 현재 NHL 순위를 가져옵니다

일정

• get-schedule : 일반 일정 정보 가져오기
• get-current-schedule : 팀의 예정된 일정을 가져옵니다.
• get-date-schedule : 특정 날짜의 일정을 가져옵니다

통계

• get-current-stat-leaders : 현재 통계적 리더를 가져옵니다
• get-current-goalie-leaders : 현재 골리 통계 리더를 가져옵니다.

계략

• get-scores-now : 현재 점수와 게임 상태를 가져옵니다.

📄 라이센스

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

🤝 기여하기

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

1. 저장소를 포크하세요
2. 기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
3. 변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )
4. 브랜치에 푸시( git push origin feature/amazing-feature )
5. 풀 리퀘스트 열기

📞 문의하기

프로젝트 관리자: Dylan Groos

참고: 이 README는 2025년 3월 10일에 실시한 테스트를 기반으로 NHL-MCP 프로젝트의 현재 상태를 문서화한 것입니다. 이 플랫폼은 NHL 데이터에 액세스하며, 이는 National Hockey League에서 정한 약관에 따라 적용됩니다.