Nba Stats Predictor MCP

🚀 NBA 數據預測應用的 MCP 服務器

這是一個基於 MCP 的工具，專為 NBA 數據預測應用程序打造。它藉助即時數據分析和高級統計建模技術，能夠精準生成球員表現預測，為用戶提供有價值的參考。

🚀 快速開始

按照以下步驟操作，你就能在Claude Desktop中使用NBA數據預測工具獲取球員表現預測啦。

📦 安裝指南

先決條件

• Python 3.8 或更高版本
• pip 包管理器
• Claude Desktop

分步安裝說明

1. 將此倉庫克隆到本地設備。
2. 切換到項目目錄：

   cd nba-stats-predictor-application
   

3. 創建虛擬環境：

   python3 -m venv venv
   

4. 激活虛擬環境：

   source venv/bin/activate
   

5. 安裝依賴項：

   pip install -r requirements.txt
   

6. 下載所需數據：

   python3 data_pipeline/download_data.py
   

7. 訓練預測模型：

   python3 models/train_model.py
   

8. 啟動 FastAPI 服務器：

   uvicorn api.fastapi_server:app --reload
   

9. 打開一個新的終端窗口。
10. 返回到項目目錄。
11. 安裝 UV 包管理器：

    curl -LsSf https://astral.sh/uv/install.sh | sh
    

12. 重新啟動當前終端。
13. 運行 MCP 服務器：

    uv run mcp_main.py
    

14. 打開另一個新的終端窗口。
15. 配置 Claude Desktop：

    code ~/Library/Application\ Support/Claude/claude_desktop_config.json
    

    ⚠️ 重要提示：如果文件不存在，請創建它。
16. 將以下配置添加到 claude_desktop_config.json 文件中：

    {
        "mcpServers": {
            "NBA-stats-predictor": {
                "command": "/實際路徑/項目目錄/.venv/bin/uv",
                "args": [
                    "--directory",
                    "/實際路徑/項目目錄/",
                    "run",
                    "mcp_main.py"
                ]
            }
        }
    }
    

    ⚠️ 重要提示：請將 /實際路徑/項目目錄/ 替換為您的實際項目路徑。
17. 現在您應該可以在 Claude Desktop 中使用此 MCP 工具了。

💻 使用示例

配置完成後，您即可在 Claude Desktop 中使用 NBA 數據預測工具來獲取即將進行的比賽的球員表現預測。

🔧 技術細節

故障排除

• 確保配置文件中的所有路徑正確無誤。
• 在運行命令之前確保已激活虛擬環境。
• 檢查所有依賴項是否正確安裝。
• 啟動 FastAPI 服務器前請確認其正在運行。