GitHub - temanuel1/nba-recap-mcp · GitHub
/" data-turbo-transient="true" />
Skip to content
Type / to search
Sign in<br>Sign upAppearance settings
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
temanuel1
nba-recap-mcp
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>9 Commits<br>9 Commits
src/nba_recap_mcp
src/nba_recap_mcp
.gitignore
.gitignore
LICENSE
LICENSE
README.md
README.md
pyproject.toml
pyproject.toml
View all files
Repository files navigation
nba-recap-mcp
An MCP server that generates AI-powered NBA game recaps by combining live game data, play-by-play stats, and real-time fan reactions from Reddit.
Requirements
Claude Desktop
Python 3.12+
uv
Internet access (no API keys required)
Setup
Add this to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
"mcpServers": {<br>"nba-recap": {<br>"command": "uvx",<br>"args": ["--from", "git+https://github.com/temanuel1/nba-recap-mcp", "nba-recap-mcp"]
Restart Claude Desktop. No cloning or local install needed.
Usage
In Claude Desktop, just type:
recap Lakers
The server will fetch the live game data, box score, play-by-play, and fan comments from Reddit, then generate a narrative recap.
Tools
Tool<br>Description
game_initializer<br>Finds today's game for a given team
box_score<br>Fetches live box score stats
play_by_play<br>Fetches play-by-play action log
subreddit_content<br>Scrapes Reddit game thread comments for fan reactions
Limitations
Works during and around live NBA games — the team must appear on today's NBA scoreboard
Requires a live game thread to exist in the team's subreddit (usually posted ~1 hour before tipoff)
Reddit calls are unauthenticated and subject to public rate limits
Troubleshooting
"No game found for X today" — the team isn't playing today, or the nickname is misspelled
Server doesn't appear in Claude Desktop — fully quit and restart the app; verify the JSON in claude_desktop_config.json is valid
Reddit returns empty comments — the game thread hasn't been posted yet, or you're being rate-limited (wait a minute and retry)
License
MIT
About<br>No description, website, or topics provided.<br>Resources<br>Readme<br>MIT license<br>Activity<br>Stars<br>0 stars<br>Watchers<br>0 watching<br>Forks<br>0 forks<br>Report repository
Releases
Packages
Contributors
Languages
You can’t perform that action at this time.