Servidor MCP Lrclib | Awesome MCP Servers

lrclib-mcp

Um servidor MCP via stdio que expõe a API de letras somente-leitura do lrclib.net como ferramentas para clientes MCP (ex.: Claude Code, Claude Desktop).

Publicar letras (/api/publish) intencionalmente não é implementado — este servidor apenas suporta a busca de letras existentes.

O servidor se comunica via stdio usando o protocolo MCP.

Ferramentas

get_lyrics — GET /api/get Busca por correspondência exata usando track_name, artist_name e, opcionalmente, album_name / duration (segundos). Melhor quando você conhece os metadados precisos da faixa; retorna um único registro.
get_lyrics_by_id — GET /api/get/{id} Busca um registro específico de letras pelo seu ID numérico (ex.: um retornado de search_lyrics).
search_lyrics — GET /api/search Busca por uma string genérica de q e/ou track_name / artist_name / album_name. Retorna um array de registros correspondentes (pode ser vazio).

Requisitos

Node.js 18+ (usa o fetch embutido)

Configurando com um cliente MCP

Exemplo de configuração do cliente (ex.: Claude Code / Claude Desktop mcpServers):

{
  "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)"
      }
    }
  }
}

Variáveis de ambiente

Ambas são opcionais e usam padrões sensatos:

Variável	Padrão	Finalidade
`LRCLIB_API_BASE`	`https://lrclib.net/api`	Substitui a URL base da API
`LRCLIB_USER_AGENT`	`lrclib-mcp/1.0.0 (+https://github.com/agroqirax/lrclib-mcp)`	Substitui o `User-Agent` enviado ao lrclib.net

HTTP Streamable

Aguardando a fusão de lrclib#115

Licença

GPL-3.0-or-later

Lrclib-mcp

Documentação