PersonalizationMCP Details

PersonalizationMCP is a unified personal data hub built on MCP (Model Context Protocol) that enables AI assistants to access and reason over data from Steam, YouTube, Bilibili, Spotify, Reddit, and more. This repository showcases a Python-based MCP server that aggregates platform APIs, manages OAuth2 tokens, and exposes a rich set of tools to query user data, playlists, watch history, and social actions. It emphasizes local data handling, token management automation, and a modular architecture that makes it easy to add new platforms through the @mcp.tool() decorator and server integration. Ideal for developers building context-aware assistants who want a single, extensible backend to surface personal data across multiple services.

The MCP server is designed to run locally on your machine with secure configuration, offering multiple installation paths (conda, uv, or pip with virtualenv). It includes a comprehensive set of available tools organized by platform, robust token management (notably YouTube), and practical guidance for configuration, testing, and cursor-based integration with consumer apps like Cursor. The project also provides detailed setup steps for each platform, including how to obtain API keys, cookies, and OAuth credentials, ensuring a smooth path from zero to a functioning personal data hub.

Use Case

Use this MCP server to centralize access to personal data across multiple platforms for AI assistants. The server exposes a comprehensive suite of tools that let you query and analyze data such as Steam libraries and achievements, YouTube video details and subscriptions, Bilibili watch history and favorites, Spotify user data and playlists, and Reddit activity and messaging. It supports automated token management (especially for YouTube), and provides integration guidance for running the server locally in various environments. Example usage from the docs:

  • Quick Start: clone and run the server

  • git clone https://github.com/YangLiangwei/PersonalizationMCP.git

  • cd PersonalizationMCP

  • python server.py (or uv run python server.py depending on setup)

  • Installation options demonstrated in the docs:

  • Option A (Conda):

  • conda create -n personalhub python=3.12

  • conda activate personalhub

  • conda install lxml

  • pip install bilibili-api --no-deps

  • pip install -r requirements.txt

  • Option B (uv):

  • uv venv

  • uv sync

  • source .venv/bin/activate

  • uv pip install lxml

  • Option C (pip):

  • python -m venv venv

  • source venv/bin/activate

  • pip install lxml

  • pip install bilibili-api --no-deps

  • pip install -r requirements.txt

  • Cursor configuration examples (environment setup) are shown as JSON blocks, e.g.:

  • {
    "mcpServers": {
    "personalhub": {
    "command": "/absolute/path/to/your/project/venv/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"
    }
    }
    }
    }
  • Testing configuration examples:

  • # Test individual platforms
    test_steam_credentials()
    test_youtube_credentials()
    test_bilibili_credentials()
    test_reddit_credentials()

    # Check overall status
    get_personalization_status()

  • YouTube token management is automated: tokens are read/ refreshed from youtube_tokens.json; there is no need to manually add YOUTUBE_ACCESS_TOKEN in config.
  • Available Tools (75)

    Examples & Tutorials

    Real usage patterns and code examples from the docs:

  • Quick Start (clone and run):

  • git clone https://github.com/YangLiangwei/PersonalizationMCP.git
    cd PersonalizationMCP

  • Installation options (from the docs):

  • # Option A: Using conda (Recommended)
    conda create -n personalhub python=3.12
    conda activate personalhub
    conda install lxml
    pip install bilibili-api --no-deps
    pip install -r requirements.txt

    # Option B: Using uv
    uv venv
    uv sync
    source .venv/bin/activate
    uv pip install lxml
    uv pip install bilibili-api --no-deps
    uv pip install aiohttp beautifulsoup4 colorama PyYAML brotli urllib3

    # Option C: Using pip (Manual Multi-Step Installation)
    python -m venv venv
    source venv/bin/activate
    pip install lxml
    pip install bilibili-api --no-deps
    pip install -r requirements.txt


  • Cursor Configuration (examples shown in the docs):

  • {
    "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"
    }
    }
    }
    }

  • Running the server (Development section):

  • # Conda
    conda activate personalhub
    python server.py

    # uv
    uv run python server.py

    # pip with virtual environment
    source venv/bin/activate # On Windows: venv\Scripts\activate
    python server.py


  • Testing configuration (from the docs):

  • # Test individual platforms
    test_steam_credentials()
    test_youtube_credentials()
    test_bilibili_credentials()
    test_reddit_credentials()

    # Check overall status
    get_personalization_status()

    Installation Guide

    Step-by-step installation instructions with actual commands from the docs:

    1) Quick Start

  • git clone https://github.com/YangLiangwei/PersonalizationMCP.git

  • cd PersonalizationMCP

  • See detailed installation instructions: Installation and Setup (link in docs)
  • 2) Install Dependencies (three options shown in the docs)

  • Option A: Using conda (Recommended)

  • conda create -n personalhub python=3.12

  • conda activate personalhub

  • conda install lxml

  • pip install bilibili-api --no-deps

  • pip install -r requirements.txt

  • Option B: Using uv

  • uv venv

  • uv sync

  • source .venv/bin/activate # On Windows: .venv\Scripts\activate

  • uv pip install lxml

  • uv pip install bilibili-api --no-deps

  • uv pip install aiohttp beautifulsoup4 colorama PyYAML brotli urllib3

  • Option C: Using pip (Manual Multi-Step Installation)

  • python -m venv venv

  • source venv/bin/activate # On Windows: venv\Scripts\activate

  • pip install lxml

  • pip install bilibili-api --no-deps

  • pip install -r requirements.txt
  • 3) Configuration Setup

  • cp config.example config

  • Edit config with your credentials as shown in the docs.
  • 4) Cursor Configuration

  • See JSON examples in Cursor Configuration section of the docs.
  • Integration Guides

    Frequently Asked Questions

    Is this your MCP?

    Claim ownership and get verified badge

    Repository Stats

    Sponsored

    Ad Space Available
    Important Notes

    Notes and cautions from the docs:

  • YouTube OAuth2 tokens are managed automatically; there is no need to manually add YOUTUBE_ACCESS_TOKEN in the configuration; tokens are read from youtube_tokens.json.

  • Bilibili cookies (sessdata, bili_jct, buvid3) can expire and require periodic updates.

  • You can configure platforms incrementally; missing credentials won't cause errors.

  • Local storage is used for API keys and tokens; no data is transmitted to third parties by the MCP server.
  • Prerequisites

    Prerequisites include: Python 3.12+ (as shown by the Python badge), obtaining API keys for Steam and YouTube, Bilibili cookies (sessdata, bili_jct, buvid3), Spotify client credentials, and Reddit client credentials. YouTube tokens are managed automatically via youtube_tokens.json; other tokens may require OAuth2 setup per platform.

    Details
    Last Updated1/2/2026
    Websitegithub.com
    SourceGitHub

    Compare Alternatives

    Similar MCP Tools

    9 related tools
    Graphiti MCP Server

    Graphiti MCP Server

    Graphiti MCP Server is an experimental implementation that exposes Graphiti's real-time, temporally-aware knowledge graph capabilities through the MCP (Model Context Protocol) interface. It enables AI agents and MCP clients to interact with Graphiti's knowledge graph for structured extraction, reasoning, and memory across conversations, documents, and enterprise data. The server supports multiple backends (FalkorDB by default and Neo4j), a variety of LLM providers (OpenAI, Anthropic, Gemini, Groq, Azure OpenAI), and multiple embedder options, all accessible via an HTTP MCP endpoint at /mcp/ for broad client compatibility. It also includes queue-based asynchronous episode processing, rich entity types for structured data, and flexible configuration through config.yaml, environment variables, or CLI arguments.

    Context7 MCP Server

    Context7 MCP Server

    Context7 MCP Server delivers up-to-date, code-first documentation and examples for LLMs and AI code editors by pulling content directly from the source. It supports multiple MCP clients and exposes tools that help you resolve library IDs and retrieve library documentation, ensuring prompts use current APIs and usage patterns. The repository provides installation and integration guides for Cursor, Claude Code, Opencode, and other clients, along with practical configuration samples and OAuth options for remote HTTP connections. This MCP server is designed to keep prompts in sync with the latest library docs, reducing hallucinations and outdated code snippets.

    TrendRadar MCP

    TrendRadar MCP

    TrendRadar MCP is an AI-driven Model Context Protocol (MCP) based analysis server that exposes a suite of specialized tools for cross-platform news analysis, trend tracking, and intelligent push notifications. It integrates with TrendRadar’s multi-platform data aggregation (RSS and trending topics) and provides advanced AI-powered insights, sentiment analysis, and cross-platform correlation. The MCP server enables developers to query, analyze, and compare news across platforms using a consistent toolset, with ongoing updates that expand capabilities such as RSS querying, date parsing, and multi-date trend analysis. This documentation references the MCP module updates, tool additions, and architecture changes that enhance extensibility, cross-platform data handling, and AI-assisted reporting.

    ChainAware Behavioural Prediction MCP

    ChainAware Behavioural Prediction MCP

    The ChainAware Behavioural Prediction MCP is an MCP-based server that provides AI-powered tools to analyze wallet behaviour prediction, fraud detection, and rug pull prediction. Designed for Web3 security and DeFi analytics, it enables developers and platforms to integrate risk assessment, predictive wallet behavior insights, and rug-pull detection through MCP-compatible clients. The server exposes three specialized tools and uses Server-Sent Events (SSE) for real-time responses, helping safeguard DeFi users, monitor liquidity risks, and score wallet or contract trustworthiness. Access to production endpoints is API-key gated, reflecting a private backend architecture that supports secure, scalable risk analytics across wallets, contracts, and pools.

    Playwright MCP

    Playwright MCP

    Playwright MCP server. A Model Context Protocol (MCP) server that provides browser automation capabilities using Playwright. This server enables large language models (LLMs) to interact with web pages through structured accessibility snapshots, bypassing the need for screenshots or visually-tuned models. The server is designed to be fast, lightweight, and deterministic, offering LLM-friendly tooling and a rich set of browser automation capabilities via MCP tools. It supports standalone operation, containerized deployments, and integration with a variety of MCP clients (Claude Desktop, VS Code, Copilot, Cursor, Goose, Windsurf, and others).

    Sequential Thinking MCP Server

    Sequential Thinking MCP Server

    Sequential Thinking MCP Server provides a dedicated MCP tool that guides problem-solving through a structured, step-by-step thinking process. It supports dynamic adjustment of the number of thoughts and allows revision and branching within a controlled workflow, making it ideal for complex analysis and solution hypothesis development. This server is designed to register a single tool, sequential_thinking, and is integrated with common MCP deployment methods (NPX, Docker) as well as editor integrations like Claude Desktop and VS Code for quick setup. The documentation provides exact configuration snippets, usage patterns, and building instructions to help you deploy and use the MCP server effectively, including Codex CLI, NPX, and Docker installation examples.

    N8N MCP Server

    N8N MCP Server

    An MCP (Model Context Protocol) server designed to integrate Claude Desktop, Claude Code, Windsurf, and Cursor with n8n workflows. This MCP enables users to build, test, and orchestrate complex workflows by exposing a set of tools that bridge Claude’s capabilities with n8n’s automation platform. The project emphasizes robust trigger handling, multi-tenant readiness, and progressive documentation to help developers understand how tools map to real-world workflow tasks. It also outlines future tooling integration points (such as getNodeEssentials and getNodeInfo) to further enhance node-structure awareness within MCP-powered automations.

    Hugging Face MCP Server

    Hugging Face MCP Server

    Hugging Face Official MCP Server connects your large language models (LLMs) to the Hugging Face Hub and thousands of Gradio AI Applications, enabling seamless MCP (Model Context Protocol) integration across multiple transports. It supports STDIO, SSE (to be deprecated but still commonly deployed), StreamableHTTP, and StreamableHTTPJson, with the Web Application allowing dynamic tool management and status updates. This MCP server is designed to be run locally or in Docker, and it provides integrations with Claude Desktop, Claude Code, Gemini CLI (and its extension), VSCode, and Cursor, making it easy to configure and manage MCP-enabled tools and endpoints. Tools such as hf_doc_search and hf_doc_fetch can be enabled to enhance document discovery, and an optional Authenticate tool can be included to handle OAuth challenges when called.

    Shadcn UI MCP Server v4

    Shadcn UI MCP Server v4

    Shadcn UI v4 MCP Server is an advanced MCP (Model Context Protocol) server designed to give AI assistants comprehensive access to shadcn/ui v4 components, blocks, demos, and metadata. It enables multi-framework support (React, Svelte, Vue, and React Native) with fast, cache-friendly access to component source code, demos, and directory structures, empowering AI-driven development workflows. The project emphasizes production-readiness with Docker Compose, SSE transport for multi-client deployments, and smart caching to optimize GitHub API usage while providing rich metadata and usage patterns for rapid prototyping and learning across frameworks.