# NBA MCP 서버

nba\_api 라이브러리를 사용하여 실시간 및 과거 NBA 통계, 생방송 경기 점수, 선수 데이터 및 팀 정보를 AI 에이전트에 제공하는 오픈 소스 모델 컨텍스트 프로토콜(MCP) 서버입니다.

Canonical URL: https://a2a-mcp.org/entry/nba-mcp-server-ko

Language: ko

Category: MCP Servers

Updated: 2026-04-21

## NBA MCP 서버란 무엇인가요?

**NBA MCP 서버**는 AI 에이전트와 포괄적인 NBA 농구 데이터를 연결하는 Model Context Protocol(MCP)의 오픈 소스 구현체입니다. 이를 통해 대형 언어 모델(예: Anthropic의 Claude)이 표준화된 MCP 도구를 통해 실시간 점수, 선수 통계, 팀 정보, 경기 기록 등을 접근할 수 있어, 사용자 정의 API 래퍼나 수동 데이터 조회가 필요하지 않습니다.

인기 있는 `nba_api` 패키지를 사용하여 Python으로 구축된 이 서버는 모든 MCP 호환 클라이언트를 지식이 풍부한 NBA 분석가로 변환시켜, "어젯밤 레이커스 경기는 누가 이겼나요?" 또는 "르브론 제임스의 이번 시즌과 지난 시즌 통계를 비교해주세요"와 같은 질문에 답할 수 있게 합니다.

## 주요 기능

- **실시간 경기 데이터**: 오늘의 스코어보드, 실시간 점수 및 경기 세부 정보 접근
- **선수 통계**: 모든 NBA 선수의 상세 커리어, 시즌 및 경기당 통계
- **팀 정보**: 로스터, 경기 기록, 순위 및 성과 지표
- **역사적 데이터**: 연도별 통계, 박스 스코어 및 고급 분석
- **MCP 도구 노출**: AI 에이전트가 자동으로 탐색하고 호출할 수 있는 `nba_list_todays_games`, 선수 검색 및 통계 쿼리와 같은 표준화된 도구
- **쉬운 배포**: 로컬에서 실행, Docker를 통한 실행 또는 독립형 서비스로 실행
- **가볍고 빠름**: 실시간 쿼리에 빠른 응답 시간과 최소한의 의존성

## 작동 방식

1. NBA MCP 서버 설치 및 실행(pip, uvx 또는 Docker를 통해)
2. MCP 클라이언트(예: Claude Desktop 구성)에서 서버 URL 또는 명령 구성
3. AI 에이전트와 자연스럽게 대화 — 에이전트가 자동으로 노출된 도구를 사용하여 정확하고 최신 NBA 데이터를 가져와 응답에 통합합니다.

서버는 필요한 경우 인증, 데이터 포맷팅 및 오류 처리를 백그라운드에서 처리합니다.

## 인기 있는 구현체

여러 커뮤니티 버전이 존재합니다:
- **obinopaul/nba-mcp-server**: 핵심 통계와 실시간 경기에 중점
- **labeveryday/nba-stats-mcp**: 쉬운 설치와 함께 포괄적인 실시간 및 역사적 데이터 제공
- 기타 선수 통계(basketball-reference), 베팅 확률 또는 고급 분석에 특화된 버전들

## 사용 사례

- **스포츠 저널리즘 및 분석**: AI 기반 요약, 비교 및 통찰력 제공
- **팬 참여 앱**: NBA 질문에 즉시 답변하는 실시간 챗봇
- **베팅 및 판타시**: 확률, 예측 및 성과 데이터 조회(호환 가능한 변형에서)
- **연구 및 교육**: 역사적 트렌드 분석 및 선수 커리어 심층 탐구
- **다중 에이전트 워크플로**: 완전한 스포츠 자동화를 위해 다른 MCP 서버(예: 뉴스 또는 캘린더)와 결합
- **개인 비서**: 실시간 경기 중 사실적 데이터로 논쟁 해결

## 시작하기

대부분 버전에서 빠른 설치를 지원합니다:

```bash
pip install nba-stats-mcp
```

# 또는
uvx nba-stats-mcp
```

그런 다음 Claude Desktop(또는 다른 MCP 클라이언트) 설정 파일에 추가합니다. 도커 옵션을 포함한 전체 설치 방법은 각 GitHub 저장소에서 확인할 수 있습니다.

기본 nba_api 사용에는 API 키가 필요하지 않습니다(요율 제한 적용).

## 장점

- **실시간 정확도**: 오래된 지식 컷오프에 의존하는 대신 항상 최신 데이터를 가져옵니다.
- **에이전트 네이티브**: 도구 호출 LLM에 특화되어 설계되었습니다.
- **개방형 및 확장 가능**: 커뮤니티 주도; 새로운 도구로 포크하거나 확장하기 쉽습니다.
- **개인정보 친화적**: 데이터 접근에 대한 완전한 통제권과 함께 로컬에서 실행됩니다.

NBA MCP 서버는 도메인 특화 MCP 서버가 어떻게 전문 지식을 AI 에이전트에게 즉시 접근 가능하게 하여, 일상적인 대화를 데이터 중심 경험으로 바꿀 수 있는지 보여주는 예시입니다.

GitHub에서 가장 적합한 변형 버전을 탐색해보세요(예: [obinopaul/nba-mcp-server](https://github.com/obinopaul/nba-mcp-server) 또는 [labeveryday/nba-stats-mcp](https://github.com/labeveryday/nba-stats-mcp)).

## Tags

- mcp
- 모델-컨텍스트-프로토콜
- nba
- 스포츠-데이터
- 농구
- ai-에이전트
- 파이썬
- 클로드
- 실시간-A분
- nba-api

## Sources

- [Project website](https://github.com/obinopaul/nba-mcp-server)