Skip to main content
Glama
opiuman

Find BGM MCP Server

by opiuman
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

Find BGM MCP Server

An MCP server that helps YouTube content creators find perfect background music for their shorts by analyzing script content and recommending tracks from YouTube Music.

Features

  • Script Analysis: Analyzes mood, theme, pacing, and sentiment from video scripts

  • Smart Recommendations: Uses YouTube Music API to find suitable background tracks

  • Duration Filtering: Ensures recommendations fit your short video length

  • Confidence Scoring: Ranks recommendations by relevance to your content

Architecture

The server follows clean architecture principles with modular design:

find_bgm/ ├── server.py # Main server entry point ├── config.py # Configuration management ├── models.py # Data models and types ├── script_analyzer.py # Script analysis logic ├── music_service.py # YouTube Music API integration ├── tools.py # MCP tool definitions └── test_server.py # Test suite

Installation

  1. Install dependencies:

pip install -r requirements.txt

  1. (Optional) Set up YouTube Music API access:

    • Follow the ytmusicapi setup guide

    • Create oauth.json file in the project directory

    • Without this, the server will use mock recommendations

Usage

The server provides one main tool: recommend_background_music

Parameters

  • script (required): Your YouTube short script/content

  • duration (required): Length of your short in seconds (15-60)

  • genre_preference (optional): "pop", "electronic", "chill", "rock", "hip-hop", "classical", "ambient", "any"

  • mood_preference (optional): "upbeat", "calm", "dramatic", "energetic", "relaxed", "motivational", "any"

  • content_type (optional): "comedy", "educational", "lifestyle", "fitness", "cooking", "travel", "tech", "other"

Example Response

{ "analysis": { "detected_mood": "motivational", "detected_theme": "fitness", "pacing": "medium", "sentiment_score": 0.4, "keywords": ["workout", "energy", "strong"] }, "recommendations": [ { "title": "Uplifting Corporate Background", "artist": "Audio Library", "youtube_music_id": "abc123", "confidence_score": 0.85, "reason": "Strong match for motivational mood and fitness content", "duration": 45, "loop_suitable": true } ] }

Configuration

Customize behavior with environment variables:

# Logging level export BGM_LOG_LEVEL=DEBUG # OAuth file location export BGM_OAUTH_FILE=my_oauth.json # Search and recommendation limits export BGM_MAX_DURATION=240 export BGM_SEARCH_LIMIT=15

YouTube Music API Setup

Method 1: Browser Authentication (Recommended)

  1. Install ytmusicapi: pip install ytmusicapi

  2. Run: ytmusicapi browser

  3. Follow prompts to paste browser headers from YouTube Music

  4. Save as oauth.json

Method 2: OAuth Setup

  1. Create Google Cloud project

  2. Enable YouTube Data API v3

  3. Create OAuth credentials

  4. Run: ytmusicapi oauth

  5. Complete authentication flow

Without the API, the server works with mock data for testing.

Running the Server

python server.py

The server runs on stdio and can be integrated with any MCP-compatible client.

Testing

# Test all components python test_server.py # Test with virtual environment source venv/bin/activate python test_server.py

Claude Desktop Integration

Add to your claude_desktop_config.json:

{ "mcpServers": { "find-bgm": { "command": "/path/to/find_bgm/venv/bin/python", "args": ["/path/to/find_bgm/server.py"] } } }

Components

ScriptAnalyzer

Analyzes script content to detect mood, theme, and pacing using natural language processing.

YouTubeMusicService & MusicRecommendationService

Handles YouTube Music API integration and generates scored recommendations.

BGMTools

MCP tool interface that orchestrates script analysis and music recommendations.

Configuration Management

Environment-based configuration with sensible defaults and type safety.

Example Usage

from models import RecommendationRequest from script_analyzer import ScriptAnalyzer from music_service import MusicRecommendationService # Analyze script analyzer = ScriptAnalyzer() analysis = analyzer.analyze_script("Your video script here") # Get recommendations service = MusicRecommendationService(music_service, config) recommendations = await service.get_recommendations( analysis, "electronic", "upbeat", 30 )

The server provides intelligent music recommendations to help creators find the perfect soundtrack for their content! 🎵

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/opiuman/mcp-bgm-recommender'

If you have feedback or need assistance with the MCP directory API, please join our Discord server