smeet666/mcp-lrclib

LRCLIB is a free, open database of song lyrics, built by
the people who use it and offered to anyone without a key or an account. It holds
two forms of the words: the plain text of a song, and the LRC form, where every
line carries the moment it is sung, which is what a karaoke display or a lyrics
panel follows along with. A track is filed there by its title, its artist, its
album and its duration, so the several releases of one song sit side by side.
This server connects a chat client to that database. You can search for a track
by title, artist or album, read the plain words of a song, read its time-synced
lines with their timestamps, and check the metadata of one release before
reading it. It needs no API key and no account.
_Version française_
---
Install
**One-click install**
**Claude Code**
**Claude Desktop, Cursor, and any client using the standard config format**
Node 24 or later is required, and no environment variable has to be set.
With Docker
-i keeps stdin open, which is where the protocol travels, and -t is left out
because a TTY rewrites the stream. The container needs outbound HTTPS to
lrclib.net, and nothing else: no volume, no port, no credential.
Bundle, without npm
Download mcp-lrclib-2.0.1.mcpb from
the latest release and
open it. A client that supports MCP bundles installs it on its own, with no npm
and no configuration file to edit. The bundle carries its dependencies, so
nothing is fetched at install time.
What you can ask
- "Find me the lyrics of Le Sud by Nino Ferrer."
- "Give me the timed lyrics of Bohemian Rhapsody so I can follow along."
- "Which version of Hallelujah is on LRCLIB, and how long is each one?"
- "Read me the second half of those lyrics."
- "Does track 3396226 have synced lyrics?"
The ordinary path runs from a search to a reading: search_tracks names an id,
and get_lyrics takes that id.
Tools
| Tool | What it does |
| --------------- | ------------------------------------------------------------- |
| search_tracks | Finds tracks by title, artist or album, with their metadata. |
| get_lyrics | Reads the words of one track, plain or with their timestamps. |
| get_track | Reads the metadata of one track by its id, without the words. |
LRCLIB files a track by its metadata, so a search reaches a song through its
title, its artist or its album. A word remembered from inside a song finds
nothing there.
search_tracks
Finds the tracks whose metadata matches, in one free-text search or in fields of
their own. Several releases of one song come back side by side, and their album
and duration tell them apart.
| Argument | Type | Required | What it does |
| ------------- | ------------------------------ | -------- | -------------------------------------------------- |
| query | string, 1 to 200 characters | no | Free-text search, as in nino ferrer le sud. |
| track_name | string, up to 200 characters | no | Song title, for a search by field. |
| artist_name | string, up to 200 characters | no | Artist name, for a search by field. |
| album_name | string, up to 200 characters | no | Album name, to narrow a search by field. |
| limit | integer, 1 to 50, default 10 | no | Rows to serve. LRCLIB answers up to 20 per search. |
Pass query, or one of the three fields.
**In return:** rows carrying id, which get_lyrics and get_track take;
track_name and artist_name; album_name and duration_seconds, which tell
two releases of one song apart; instrumental; has_plain_lyrics and
has_synced_lyrics, so timed lines can be checked for before they are asked
for; and source_url. Alongside come result_count and total_available, the
tracks LRCLIB served before limit was applied. album_name and
duration_seconds are null on a track filed without them, and the rows carry
no words at all: get_lyrics reads those.
get_lyrics
Reads the words of one track, either as plain text or as LRC lines carrying the
moment each one is sung. Long lyrics are served a slice at a time, resuming at a
line boundary.
| Argument | Type | Required | What it does |
| ------------------ | -------------------------------------------- | -------- | ------------------------------------------------------------- |
| id | integer, positive | no | The LRCLIB track id, as search_tracks returned it. |
| artist_name | string, up to 200 characters | no | Artist name, matched exactly. Needed when id is absent. |
| track_name | string, up to 200 characters | no | Song title, matched exactly. Needed when id is absent. |