Sport5 Fantasy MCP Server עם Google OAuth

תיאור

שרת MCP (Model Context Protocol) להתחברות וניהול נתונים של אתר הפנטזי של ספורט 5. השרת תומך בשני סוגי התחברות:

התחברות Google OAuth - אבטחה מתקדמת דרך Google
התחברות רגילה - עם מייל וסיסמה

תכונות

✅ התחברות דרך Google OAuth 2.0
✅ התחברות רגילה עם פרטי משתמש
✅ קבלת פרטי הקבוצה שלך
✅ צפייה בטבלת הליגה
✅ שרת OAuth מקומי לטיפול ב-callbacks
✅ תמיכה בעברית ואנגלית
✅ לוגים מפורטים ומידע על שגיאות

הגדרת Google OAuth

שלב 1: יצירת Google OAuth Client

כנס ל-Google Cloud Console
צור פרויקט חדש או בחר פרויקט קיים
הפעל את "Google OAuth2 API"
עבור ל-"APIs & Services" > "Credentials"

שלב 2: הגדרת OAuth Consent Screen

לחץ על "OAuth consent screen"
בחר "External" (אלא אם יש לך Google Workspace)
מלא את השדות הנדרשים:
- Application name: Sport5 Fantasy MCP
- User support email: המייל שלך
- Developer contact information: המייל שלך
- Authorized domains: הוסף localhost (לפיתוח)

שלב 3: יצירת OAuth 2.0 Client ID

לחץ על "Create Credentials" > "OAuth 2.0 Client ID"
Application type: Web application
Name: Sport5 Fantasy Client
Authorized redirect URIs: הוסף http://localhost:8000/oauth/callback
לחץ "Create"
שמור את:
- Client ID: נראה כמו 123456789-abc.apps.googleusercontent.com
- Client Secret: נראה כמו GOCSPX-abc123...

התקנה

דרישות מקדימות

Python 3.8+
pip package manager

התקנת חבילות

pip install -r requirements.txt

או להתקנה ידנית:

pip install aiohttp beautifulsoup4 mcp lxml aiohttp-cors python-dotenv

הגדרת משתני סביבה (אופציונלי)

צור קובץ .env עם הפרטים שלך:

GOOGLE_CLIENT_ID=your-client-id-here GOOGLE_CLIENT_SECRET=your-client-secret-here

הפעלה

הפעלת השרת

python sport5_mcp_google.py

השרת יתחיל להאזין על stdio ויהיה מוכן לחיבור עם Claude.

הגדרה עם Claude Desktop

הוסף את הקונפיגורציה הבאה ל-claude_desktop_config.json:

{ "mcpServers": { "sport5-fantasy-oauth": { "command": "python", "args": ["C:\\path\\to\\your\\sport5_mcp_google.py"], "env": { "GOOGLE_CLIENT_ID": "your-client-id", "GOOGLE_CLIENT_SECRET": "your-client-secret" } } } }

שימוש

1. הגדרת Google OAuth

הגדר Google OAuth עם: Client ID: 123456789-abc.apps.googleusercontent.com Client Secret: GOCSPX-abc123...

2. התחברות דרך Google

התחבר דרך Google OAuth

השרת יפתח דפדפן להתחברות. לאחר האישור, חזור ל-Claude.

3. התחברות רגילה (אלטרנטיבה)

התחבר לאתר הפנטזי עם המייל myemail@example.com והסיסמה mypassword

4. קבלת נתונים

הראה את הקבוצה שלי הראה את טבלת הליגה

כלים זמינים

כלי	תיאור	פרמטרים נדרשים
`setup_google_oauth`	הגדרת OAuth של Google	`client_id` , `client_secret`
`login_google`	התחברות דרך Google	ללא
`login_credentials`	התחברות רגילה	`email` , `password`
`get_my_team`	קבלת פרטי הקבוצה	ללא
`get_league_table`	קבלת טבלת הליגה	ללא

מבנה הפרויקט

Sport5FantasyLeagueMCPServer/ ├── sport5_mcp_google.py # השרת הראשי ├── requirements.txt # חבילות נדרשות ├── .env.example # דוגמה למשתני סביבה ├── .env # משתני סביבה (לא נכלל ב-git) └── README.md # התיעוד הזה

זרימת עבודה

הגדרה ראשונית: הפעלת השרת + הגדרת Google OAuth
התחברות: בחירה בין Google OAuth או התחברות רגילה
שימוש: קבלת נתוני קבוצה, טבלאות ליגה, וכו'
ניתוק: הפגישה נשמרת עד סגירת השרת

השוואה בין דרכי התחברות

Google OAuth

✅ אבטחה גבוהה יותר
✅ לא צריך לשמור סיסמאות
✅ תמיכה ברענון אוטומטי
❌ דורש הגדרה מורכבת יותר
❌ תלוי באתר ספורט 5 שיתמוך בGoogle OAuth

התחברות רגילה

✅ פשוט להגדרה
✅ עובד עם כל אתר
✅ ישיר ומהיר
❌ צריך לשמור פרטי התחברות (זמנית)
❌ פחות מאובטח

פתרון בעיות

Google OAuth לא עובד

בעיה: שגיאת redirect URI

הפתרון: ודא שה-redirect URI במדויק: http://localhost:8000/oauth/callback

בעיה: השרת לא מגיב

הפתרון: בדוק שהשרת רץ על פורט 8000 ושאין חומת אש חוסמת

בעיה: Client ID או Secret שגויים

הפתרון: בדוק את הפרטים ב-Google Cloud Console

אתר ספורט 5 לא מכיר Google OAuth

במקרה זה האתר לא תומך בהתחברות Google. פתרונות:

השתמש בהתחברות רגילה
בדוק אם יש אפשרות ליצור חשבון חדש דרך Google באתר
צור קשר עם תמיכת האתר

שגיאות הרשאות

הפתרון: ודא שהמשתמש שלך מאושר ב-OAuth consent screen

שגיאות התקנה

# Windows - אם יש בעיות עם lxml pip install --upgrade pip setuptools wheel pip install lxml --force-reinstall # בעיות עם aiohttp pip install aiohttp --force-reinstall

אבטחה וביטחון

🔒 סיסמאות נשמרות רק בזיכרון במשך הפגישה
🔒 Google OAuth משתמש בתקני OAuth 2.0 מתקדמים
🔒 כל התקשורת עם Google מוצפנת (HTTPS)
🔒 State parameter מונע CSRF attacks
🔒 מומלץ להשתמש ב-HTTPS בפרודקשן

פיתוח והרחבות

הוספת תכונות חדשות

הוסף כלי חדש ב-handle_list_tools()
מימש את הלוגיקה ב-handle_call_tool()
הוסף פונקציונליות ל-Sport5FantasyClient

דיבוג

הפעל עם רמת לוג מפורטת:

logging.basicConfig(level=logging.DEBUG)

תרומה לפרויקט

Fork הרפוזיטורי
צור branch חדש לתכונה
עשה commit לשינויים
שלח Pull Request

רישיון

פרויקט זה הוא קוד פתוח ונמצא תחת רישיון MIT.

יצירת קשר

אם יש שאלות או בעיות, אנא פתח Issue בגיטהאב או צור קשר.

This server cannot be installed

-

security - not tested

-

license - not tested

-

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables full automation of Sport5 Fantasy League management including team analysis, player searches, automatic transfers, captain selection, and optimization recommendations. Supports Hebrew interface and provides comprehensive fantasy football team management through natural language commands.

Sport5 Fantasy League MCP Server