Servidor MCP de Lrclib | Awesome MCP Servers

lrclib-mcp

Un servidor MCP por stdio que expone la API de letras de solo lectura de lrclib.net como herramientas para clientes MCP (p. ej., Claude Code, Claude Desktop).

La publicación de letras (/api/publish) no está implementada intencionalmente; este servidor solo admite la búsqueda de letras existentes.

El servidor se comunica a través de stdio usando el protocolo MCP.

Herramientas

get_lyrics — GET /api/get Búsqueda de coincidencia exacta por track_name, artist_name y, opcionalmente, album_name / duration (segundos). Mejor cuando conoces los metadatos precisos de la pista; devuelve un único registro.
get_lyrics_by_id — GET /api/get/{id} Obtén un registro de letras específico por su ID numérico (p. ej., uno devuelto por search_lyrics).
search_lyrics — GET /api/search Busca por una cadena q genérica y/o track_name / artist_name / album_name. Devuelve un arreglo de registros coincidentes (puede estar vacío).

Requisitos

Node.js 18+ (usa el fetch integrado)

Configuración con un cliente MCP

Ejemplo de configuración de cliente (p. ej., 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)"
      }
    }
  }
}

Variables de entorno

Ambas son opcionales y recurren a valores predeterminados razonables:

Variable	Predeterminado	Propósito
`LRCLIB_API_BASE`	`https://lrclib.net/api`	Anula la URL base de la API
`LRCLIB_USER_AGENT`	`lrclib-mcp/1.0.0 (+https://github.com/agroqirax/lrclib-mcp)`	Anula el `User-Agent` enviado a lrclib.net

HTTP transmisible

Esperando que se fusione lrclib#115

Licencia

GPL-3.0-or-later

Lrclib-mcp

Documentación