YP

yangliangwei/personalizationmcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

63 stars 7 forks 质量 71 趋势 13MIT

🎯 一个基于MCP构建的统一个人数据中心,允许AI助手通过Steam、YouTube、Bilibili等平台访问您的数字生活,实现真正个性化的互动。

概览

一个基于MCP(模型上下文协议)构建的统一个人数据中心,允许AI助手从多个平台访问您的数字生活,提供真正个性化且具上下文的互动。 - : personalhub 入职 - : personalhub-manager 技能 - : 独立技能支持 Steam / YouTube / Bilibili / Spotify / Reddit - : 一项技能一次领导一项任务 - 获取包含详细统计数据和游戏时间的游戏库 - 查看近期游戏活动和当前游戏 - 获取详细游戏信息和成就 - 与朋友比较游戏并获得推荐 - 分析游戏习惯和偏好 - 搜索YouTube视频并获取详细视频信息 - 获取频道信息和热门视频 - 通过OAuth2访问个人数据(订阅、播放列表、点赞视频) - 根据你的观看历史获得个性化推荐 - 🔄 - 自动检测并刷新过期的OAuth2令牌 - 🛡️ - 优先排序令牌文件,无需手动......

概述(AI 翻译)

一个基于MCP(模型上下文协议)构建的统一个人数据中心,允许AI助手从多个平台访问您的数字生活,提供真正个性化且具上下文的互动。

📖 中文文档:README_zh.md

🚀 快速入门(当前推荐流畅)

  1. 克隆并安装

  2. 运行入职(互动)

  3. 或运行入职(非交互式/可脚本化)

  4. 验证并运行

🧭 项目现状

  • 统一设置条目:personalhub onboarding
  • 统一操作条目:personalhub-manager技能
  • 平台特定流程:Steam / YouTube / Bilibili / Spotify / Reddit 的独立技能
  • 无嵌套技能执行:一项技能一次领导一项任务

🌟 特色

🎮 Steam集成

  • 获取包含详细统计数据和游戏时长的游戏库
  • 查看近期游戏活动及当前游戏
  • 获取详细的游戏信息和成就
  • 与朋友对比游戏并获得推荐
  • 分析游戏习惯和偏好

🎥 YouTube 集成

  • 搜索YouTube视频并获取详细视频信息
  • 获取频道信息和热门视频

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

🎯 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

  1. Clone and install

    git clone https://github.com/YangLiangwei/PersonalizationMCP.git
    cd PersonalizationMCP
    
    # choose one
    uv venv && uv sync
    # or
    python3 -m venv venv && source venv/bin/activate && pip install -r requirements.txt
    
  2. Run onboarding (interactive)

    personalhub onboarding --all
    
  3. Or run onboarding (non-interactive / scriptable)

    personalhub onboarding --platform steam --set STEAM_API_KEY=xxx --set STEAM_USER_ID=7656119xxx
    personalhub onboarding --platform youtube --set YOUTUBE_API_KEY=xxx
    
  4. Verify and run

    personalhub status
    personalhub serve --profile safe
    

🧭 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
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "personalhub": { "command": "/path/to/your/conda/envs/personalhub/bin/python", "args": ["/absolute/path/to/your/project/server.py"], "env": { "STEAM_API_KEY": "your_steam_api_key", "STEAM_USER_ID": "your_steam_user_id", "YOUTUBE_API_KEY": "your_youtube_api_key", "BILIBILI_SESSDATA": "your_bilibili_sessdata", "BILIBILI_BILI_JCT": "your_bilibili_bili_jct", "BILIBILI_BUVID3": "your_bilibili_buvid3", "REDDIT_CLIENT_ID": "your_reddit_client_id", "REDDIT_CLIENT_SECRET": "your_reddit_client_secret" } } } }