Spotify Server

by superseoworld

About

ArtistLens provides comprehensive access to the Spotify Web API through the Model Context Protocol, enabling interaction with Spotify's music catalog including tracks, albums, artists, playlists, and audiobooks. Key features include: - Full-text search across tracks, albums, artists, playlists, and audiobooks - Detailed artist information including top tracks, related artists, and complete album discographies - Album metadata and track listings with pagination support - Playlist management including creation, modification, public/private settings, and track access - Music discovery through new releases and personalized recommendations - Audiobook access with chapter listings and market-specific content - Automatic OAuth token management and client credentials authentication flow

README

ArtistLens

[](https://smithery.ai/server/@superseoworld/artistlens) [](https://www.npmjs.com/package/@thomaswawra/artistlens)

A powerful Model Context Protocol (MCP) server that provides access to the Spotify Web API. ArtistLens enables seamless interaction with Spotify's music catalog, including searching for tracks, albums, and artists, as well as accessing artist-specific information like top tracks and related artists.

Current Version: 0.4.12

Installation

Installing via Smithery

To install ArtistLens for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @superseoworld/artistlens --client claude

Manual Installation

You can install the package globally:

npm install -g @thomaswawra/artistlens

Or run it directly with npx:

npx -y @thomaswawra/artistlens

Configuration

Add to your MCP settings file (e.g., claude_desktop_config.json or cline_mcp_settings.json):

{
  "mcpServers": {
    "spotify": {
      "command": "npx",
      "args": ["-y", "@thomaswawra/artistlens"],
      "env": {
        "SPOTIFY_CLIENT_ID": "your_client_id",
        "SPOTIFY_CLIENT_SECRET": "your_client_secret"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

You'll need to provide your Spotify API credentials: 1. Go to Spotify Developer Dashboard 2. Create a new application 3. Get your Client ID and Client Secret 4. Add them to the configuration as shown above

Features

Search for tracks, albums, artists, and playlists

Get artist information including top tracks and related artists

Get album information and tracks

Access new releases and recommendations

Get audiobook information with market-specific content and chapters

Note: Audiobook endpoints may require additional authentication or market-specific access

Get and modify playlist information (name, description, public/private status)

Access playlist tracks and items with pagination support

Support for both Spotify IDs and URIs

Automatic token management with client credentials flow

Comprehensive test suite for all functionality

Well-organized code with separation of concerns

Available Tools

get_access_token: Get a valid Spotify access token

search: Search for tracks, albums, artists, or playlists

get_artist: Get artist information

get_artist_top_tracks: Get an artist's top tracks

get_artist_related_artists: Get artists similar to a given artist

get_artist_albums: Get an artist's albums

get_album: Get album information

get_album_tracks: Get an album's tracks

get_track: Get track information

get_available_genres: Get a list of available genres for recommendations

get_new_releases: Get new album releases

get_recommendations: Get track recommendations based on seed tracks, artists, or genres

get_audiobook: Get audiobook information with optional market parameter

get_multiple_audiobooks: Get information for multiple audiobooks (max 50)

get_audiobook_chapters: Get chapters of an audiobook with pagination support (1-50 chapters per request)

get_playlist: Get a playlist owned by a Spotify user

get_playlist_tracks: Get full details of the tracks of a playlist (1-100 tracks per request)

get_playlist_items: Get full details of the items of a playlist (1-100 items per request)

modify_playlist: Change playlist details (name, description, public/private state, collaborative status)

add_tracks_to_playlist: Add one or more tracks to a playlist with optional position

remove_tracks_from_playlist: Remove one or more tracks from a playlist with optional positions and snapshot ID

get_current_user_playlists: Get a list of the playlists owned or followed by the current Spotify user (1-50 playlists per request)

get_featured_playlists: Get a list of Spotify featured playlists with optional locale and pagination support

get_category_playlists: Get a list of Spotify playlists tagged with a particular category

Updating

To update to the latest version:

# If installed globally
npm update -g @thomaswawra/artistlens
If using npx, it will automatically use the latest version
npx -y @thomaswawra/artistlens

Development

This project is open source and available on GitHub at https://github.com/superseoworld/artistlens.

Project Structure

The codebase is organized into the following directories:

src/handlers/: Contains handler classes for different Spotify API endpoints

src/types/: T

Related MCP Servers

AI Research Assistant

hamid-vakilzadeh

AI Research Assistant provides comprehensive access to millions of academic papers through the Semantic Scholar and arXiv databases. This MCP server enables AI coding assistants to perform intelligent literature searches, citation network analysis, and paper content extraction without requiring an API key. Key features include: - Advanced paper search with multi-filter support by year ranges, citation thresholds, field of study, and publication type - Title matching with confidence scoring for finding specific papers - Batch operations supporting up to 500 papers per request - Citation analysis and network exploration for understanding research relationships - Full-text PDF extraction from arXiv and Wiley open-access content (Wiley TDM token required for institutional access) - Rate limits of 100 requests per 5 minutes with options to request higher limits through Semantic Scholar

Web & Search

12 8

Arch Linux [ Not Updated ]

nihalxkumar

Arch Linux MCP Server connects AI assistants to the Arch Linux ecosystem, enabling intelligent access to the Arch Wiki, AUR (Arch User Repository), and official package repositories. Key features: - Search and retrieve Arch Wiki documentation in markdown format via `archwiki://` URIs - Query package details from official repositories (`archrepo://`) and AUR (`aur://*/info`) - Analyze PKGBUILDs with built-in safety checks before installation (`aur://*/pkgbuild`) - Access system package state on Arch systems including installed packages, orphans, explicit packages, and package groups - Works on both Arch and non-Arch systems for documentation lookup and package research - Guided workflows for safe AUR installations and system troubleshooting

Developer Tools

41 25

joemcp

lumberjack-so

JoeAPI is a construction management platform that helps contractors and construction teams manage projects, clients, and business operations through an integrated system. Key capabilities include: - Client and contact management with CRM functionality - Project lifecycle management from proposals and estimates through completion - Action item tracking with supervisor assignments and schedule coordination - Financial monitoring with project summaries and detailed cost views - 18 pre-built workflows for common construction management tasks - 60+ API tools for CRUD operations on construction data The MCP server supports both cloud deployment via Smithery and local STDIO transport for development use.

Productivity

26 1