lrclib-mcp

A stdio MCP server that exposes the read-only lrclib.net lyrics API as tools for MCP clients (e.g. Claude Code, Claude Desktop).

0 stars JavaScriptOthers Updated Jul 28, 2026

aiclaudelrcliblyricsmcp

Documentation

lrclib-mcp

A stdio MCP server that exposes the read-only

lrclib.net lyrics API as tools for MCP clients (e.g.

Claude Code, Claude Desktop).

Publishing lyrics (`/api/publish`) is intentionally not implemented — this

server only supports looking up existing lyrics.

The server communicates over stdio using the MCP protocol

Tools

get_lyrics — `GET /api/get`

Exact-match lookup by `track_name`, `artist_name`, and optionally

`album_name` / `duration` (seconds). Best when you know precise track

metadata; returns a single record.

get_lyrics_by_id — `GET /api/get/{id}`

Fetch a specific lyrics record by its numeric ID (e.g. one returned from

`search_lyrics`).

search_lyrics — `GET /api/search`

Search by a generic `q` string and/or `track_name` / `artist_name` /

`album_name`. Returns an array of matching records (may be empty).

Requirements

Node.js 18+ (uses the built-in `fetch`)

Configuring with an MCP client

Example client config (e.g. Claude Code / Claude Desktop `mcpServers`):

json

{
  "mcpServers": {
    "lrclib": {
      "command": "npx",
      "args": ["-y", "git+https://github.com/agroqirax/lrclib-mcp.git"],
      "env": {
        "LRCLIB_API_BASE": "https://lrclib.net/api",
        "LRCLIB_USER_AGENT": "lrclib-mcp/1.0.0 (+https://github.com/agroqirax/lrclib-mcp)"
      }
    }
  }
}

Environment variables

Both are optional and fall back to sane defaults:

Variable	Default	Purpose
`LRCLIB_API_BASE`	`https://lrclib.net/api`	Override the API base URL
`LRCLIB_USER_AGENT`	`lrclib-mcp/1.0.0 (+https://github.com/agroqirax/lrclib-mcp)`	Override the `User-Agent` sent to lrclib.net

Streamable HTTP

Awaiting lrclib#115 being merged

License

GPL-3.0-or-later

Frequently asked questions

What is lrclib-mcp?

lrclib-mcp is A stdio MCP server that exposes the read-only lrclib.net lyrics API as tools for MCP clients (e.g. Claude Code, Claude Desktop).

How do I install lrclib-mcp?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is lrclib-mcp open source?

Yes — it is hosted on GitHub at https://github.com/Agroqirax/lrclib-mcp.

Related MCP tools

papersgpt-for-zotero

A powerful Zotero AI and MCP plugin with ChatGPT, Gemini 3.7, Claude Fable 5, Claude Opus 5, DeepSeek V4, Grok, OpenRouter, Kimi k3, GLM 5.3, SiliconFlow, GPT-oss, Gemma 4, Qwen 3.8

2,625 JavaScript

zoteromistralclaude+17

atlassian-mcp-server

Official remote MCP server for Atlassian. Securely connect Jira, Confluence, Jira Service Management, Bitbucket, and Compass to Claude, ChatGPT, Cursor, VS Code, and other AI tools using OAuth 2.1 or API tokens.

1,015 JavaScript

aiai-agentsatlassian+17

firecrawl-mcp-server

🔥 Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients.

7,393 JavaScript

batch-processingclaudecontent-extraction+11

unity-mcp

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

13,915 C#

aiai-integrationmcp+13

wigolo

The go-to web for your AI coding agent — local-first search, fetch, crawl & research over MCP. No API keys, no cloud, $0/query. Public beta.

4,906 TypeScript

mcpagentai+17

Unity-MCP

AI Skills, MCP Tools, and CLI for Unity Engine. Full AI develop and test loop. Use cli for quick setup. Efficient token usage, advanced tools. Any C# method may be turned into a tool by a single line. Works with Claude Code, Gemini, Copilot, Cursor and any other absolutely for free.

4,137 C#

aiai-integrationgame-development+16

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP