YangLiangwei/PersonalizationMCP

A unified personal data hub built on MCP (Model Context Protocol) that allows AI assistants to access your digital life from multiple platforms, providing truly personalized and contextual interactions.
> 📖 **中文文档**: README_zh.md
🚀 Quick Start (Current Recommended Flow)
1. **Clone and install**
2. **Run onboarding (interactive)**
3. **Or run onboarding (non-interactive / scriptable)**
4. **Verify and run**
🧭 How the Project Works Now
- **Unified entry for setup**: personalhub onboarding
- **Unified entry for operations**: personalhub-manager skill
- **Platform-specific flows**: independent skills for Steam / YouTube / Bilibili / Spotify / Reddit
- **No nested skill execution**: one skill leads a task at a time
🌟 Features
🎮 Steam Integration
- Get your game library with detailed statistics and playtime
- View recent gaming activity and currently playing games
- Get detailed game information and achievements
- Compare games with friends and get recommendations
- Analyze gaming habits and preferences
🎥 YouTube Integration
- Search YouTube videos and get detailed video information
- Get channel information and trending videos
- Access personal data with OAuth2 (subscriptions, playlists, liked videos)
- Get personalized recommendations based on your viewing history
- 🔄 **Smart Token Management** - Automatically detect and refresh expired OAuth2 tokens
- 🛡️ **Maintenance-Free Configuration** - Prioritize token files, no need to manually update MCP configuration
📺 Bilibili Integration
- Get user profile information and statistics
- Search videos and get detailed video information
- Access personal data (watch history, favorites, liked videos, coin history)
- Get following list and user-uploaded videos
- Browse "to view later" list and personal collections
🎵 Spotify Integration
- Complete OAuth2 authentication with automatic token management
- Get user profile and music library data
- Access top artists, tracks, and recently played music
- Social features: follow/unfollow artists and playlists
- Library management: saved tracks, albums, shows, episodes, audiobooks
- Playlist operations: view and manage personal playlists
💬 Reddit Integration
- Complete OAuth2 authentication with automatic token management
- Access user account information, karma breakdown, and preferences
- Get submitted posts, comments, and user activity overview
- View saved content, hidden posts, and voting history
- Explore subscribed communities and moderation permissions
- Message system access (inbox, unread, sent messages)
📦 Installation and Setup
1. Install Dependencies
Due to the complexity of bilibili-api dependencies (especially lxml compilation issues), installation requires specific steps. Choose one of the methods below:
**Option A: Using conda (Recommended)**
**Option B: Using uv**
**Option C: Using pip (Manual Multi-Step Installation)**
> **⚠️ Important**: The bilibili-api package has complex dependency requirements that can cause compilation failures on some systems. The multi-step installation approach ensures compatibility by installing lxml first, then bilibili-api without its conflicting dependencies, and finally all other required packages.
2. Configuration Setup
Copy the example configuration file and fill in your credentials:
Then edit the config file with your actual API keys and tokens.
🔧 Platform Configuration
🎮 Steam API Setup
> 📖 **Detailed setup guide**: platforms/steam/README.md | 中文指南
**Quick summary**: Get Steam API key and User ID, then configure:
🎥 YouTube API Setup
> 📖 **Detailed setup guide**: platforms/youtube/README.md | 中文指南
**Quick summary**:
1. Get YouTube API key from Google Cloud Console
2. For personal data access, set up OAuth2 with "TV and Limited Input device" type
3. Use MCP tools for easy authentication
**Configuration:**
📺 Bilibili Setup
> 📖 **Detailed setup guide**: platforms/bilibili/README.md | 中文指南
**Quick summary**: Extract cookies from your browser after logging into Bilibili
**Configuration:**
🎵 Spotify API Setup
> 📖 **Detailed setup guide**: platforms/spotify/README.md | 中文指南
**Quick summary**: