elcachorrohumano/lastfm-mcp-server

Last.fm MCP Server

A Model Context Protocol (MCP) server that provides access to Last.fm music data and discovery capabilities.

Available Tools

Artist Tools

• search_artists - Search for artists by name
• get_artist_info - Get detailed artist information and biography
• get_artist_top_albums - Get an artist's most popular albums
• get_artist_top_tracks - Get an artist's most popular tracks

Album Tools

• search_albums - Search for albums by name
• get_album_info - Get detailed album information and tracklist
• get_album_top_tags - Get tags associated with an album

Track Tools

• search_tracks - Search for tracks by name
• get_track_info - Get detailed track information
• get_similar_tracks - Find tracks similar to a given track
• get_track_top_tags - Get tags associated with a track

User Tools

• get_user_info - Get user profile information
• get_user_recent_tracks - Get a user's recently played tracks
• get_user_top_artists - Get a user's most played artists
• get_user_top_albums - Get a user's most played albums
• get_user_top_tracks - Get a user's most played tracks
• get_user_loved_tracks - Get tracks a user has marked as loved

Chart Tools

• get_top_artists - Get global top artists
• get_top_tracks - Get global top tracks
• get_top_tags - Get popular music tags

Tag Tools

• get_tag_info - Get information about a music tag
• get_tag_top_artists - Get top artists for a tag
• get_tag_top_albums - Get top albums for a tag
• get_tag_top_tracks - Get top tracks for a tag
• get_tag_weekly_charts - Get weekly chart data for a tag

Write Operations (Authentication Required)

• scrobble_track - Scrobble a track to user's profile
• love_track - Mark a track as loved
• unlove_track - Remove love from a track
• update_now_playing - Update what's currently playing
• add_track_tags - Add tags to a track
• remove_track_tag - Remove a tag from a track

Authentication Tools

• get_auth_token - Get authentication token for user login
• get_auth_session - Convert token to session for API access

Setup

Prerequisites

1. Get Last.fm API credentials at Last.fm API
2. Copy .env.example to .env and add your credentials:

   LASTFM_API_KEY=your_actual_api_key_here
   LASTFM_SHARED_SECRET=your_actual_shared_secret_here
   

VS Code/Cursor Setup

Option 1: Docker (Recommended)

First build the image:

docker build -t lastfm-mcp .

Then add to your VS Code/Cursor MCP configuration:

{
  "mcpServers": {
    "lastfm-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env-file",
        "/path/to/your/.env",
        "lastfm-mcp"
      ]
    }
  }
}

Important: Replace /path/to/your/.env with the actual path to your .env file.

Option 2: UV

Add to your VS Code/Cursor MCP configuration:

{
  "mcpServers": {
    "lastfm-mcp": {
      "command": "/path/to/uv",
      "args": [
        "--directory",
        "/path/to/your/project",
        "run",
        "--env-file",
        ".env",
        "mcp_server.py"
      ]
    }
  }
}

Important:

• Replace /path/to/uv with the actual path to your UV installation. Run which uv in your terminal to find the path (e.g., /usr/local/bin/uv, /home/user/.local/bin/uv, or just uv if it's in your PATH)
• Replace /path/to/your/project with the actual absolute path to your project directory