tfmart/ScrobblerContext

ScrobblerContext - Last.fm MCP Server

A Model Context Protocol (MCP) server that provides access to Last.fm's music database. Built in Swift, it enables AI assistants to search for music, manage user libraries, and scrobble tracks.

Table of Contents

• Features
• Quick Start
• Setup with MCP Clients
• Usage Examples
• Manual Installation
• Available Tools
• Contributing
• Documentation
• Troubleshooting
• License
• Acknowledgments

Features

• Authentication: Secure browser OAuth flow with session persistence
• Artist Operations: Search artists, get detailed information, find similar artists
• Album Operations: Search albums, get track listings and metadata
• Track Operations: Search tracks, get details and recommendations
• User Data: Access listening history, statistics, and social features
• Scrobbling: Submit track plays, update now playing status, love/unlove tracks

Quick Start

Install via npm (Recommended)

# Install globally
npm install -g scrobblercontext-mcp

# Set up your Last.fm API credentials
export LASTFM_API_KEY="your_api_key_here"
export LASTFM_SECRET_KEY="your_secret_key_here"

# Run the server
scrobblercontext-mcp

Get Last.fm API Credentials

1. Visit Last.fm API Account Creation
2. Fill in the application details:
   • Application Name: Your app name (e.g., "My MCP Server")
   • Application Description: Brief description
   • Application Homepage URL: Your website (can be GitHub repo)
   • Callback URL: http://localhost:8080/callback (for OAuth)
3. Save your API Key and Shared Secret

Setup with MCP Clients

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "lastfm": {
      "command": "scrobblercontext-mcp",
      "env": {
        "LASTFM_API_KEY": "your_api_key_here",
        "LASTFM_SECRET_KEY": "your_secret_key_here"
      }
    }
  }
}

Configuration file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

Cursor

Add to your MCP settings:

{
  "mcpServers": {
    "lastfm": {
      "command": "scrobblercontext-mcp",
      "env": {
        "LASTFM_API_KEY": "your_api_key_here", 
        "LASTFM_SECRET_KEY": "your_secret_key_here"
      }
    }
  }
}

Other MCP Clients

The server communicates over stdio following the Model Context Protocol standard. Configure your client to:

1. Execute scrobblercontext-mcp as the server command
2. Set the required environment variables
3. Use stdio transport

Usage Examples

Authenticate with Last.fm:

User: "Authenticate with Last.fm"
Assistant: [Uses authenticate_browser tool to start OAuth flow]

Search for music:

User: "Find artists similar to Radiohead" 
Assistant: [Uses get_similar_artists tool to find recommendations]

Scrobble tracks:

User: "Scrobble 'Bohemian Rhapsody' by Queen"
Assistant: [Uses scrobble_track tool to submit to your profile]

Manual Installation

Prerequisites:

• Swift 6.0+ (Download)
• macOS 13.0+ or Linux with Swift support
• Last.fm API credentials

Build from source:

git clone https://github.com/tfmart/ScrobblerContext
cd ScrobblerContext
swift build
export LASTFM_API_KEY="your_api_key_here"
export LASTFM_SECRET_KEY="your_secret_key_here"
swift run ScrobblerContext

Available Tools

Contributing

Contributions are welcome! Please see for guidelines.

Documentation

• API Documentation - Auto-generated from code
• - Development setup and guidelines
• Model Context Protocol - MCP specification
• Last.fm API - Last.fm API documentation

Troubleshooting

Swift not found: Install Swift from swift.org

Invalid session key: Re-run authentication with authenticate_browser

API key errors: Verify your LASTFM_API_KEY and LASTFM_SECRET_KEY are correct

Server disconnects: Check environment variables are set in MCP client config

License

MIT License - see file for details.

Acknowledgments

• Last.fm for the music data API
• ScrobbleKit for the Swift Last.fm SDK
• Model Context Protocol for the communication standard