歌词查询服务

一个通过LyricsGenius库访问Genius.com上的歌曲歌词和艺术家信息的MCP服务器,提供艺术家、歌曲、专辑的搜索和详细信息获取功能。

  • by WinstonFassett
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 WinstonFassett/lyricsgenius-mcp-server

使用说明

LyricsGenius MCP服务器

模型上下文协议(MCP)服务器,用于通过LyricsGenius库从Genius.com访问歌词和艺术家信息。

特性

  • 在Genius.com上搜索艺术家和歌曲
  • 获取艺术家的详细信息
  • 检索歌词
  • 获取艺术家专辑和热门歌曲
  • 获取专辑曲目
  • 搜索不同的内容类型(歌曲、艺术家、专辑等)

需求

  • Python 3.8+
  • LyricsGenius API令牌(从https://genius.com/api-clients)

安装

  1. 克隆此存储库

    git clone <repository-url>
    cd lyricsgenius-mcp
    
  2. 创建虚拟环境

    uv venv
    source .venv/bin/activate  # On Windows: .venv\Scripts\activate
    
  3. 安装依赖项

    uv pip install -r requirements.txt
    
  4. 设置Genius API令牌

    • 创建以下内容的副本 .env 并将其重命名为 .env
    • 替换 your_token_here 使用您的Genius API代币

用法

直接运行服务器

python server.py

在Claude Desktop中安装

mcp install server.py

使用MCP开发工具运行

mcp dev server.py

服务器功能

工具

  • search(query, search_type=None, per_page=10, page=1) -在Genius中搜索艺术家、歌曲、专辑或其他内容
  • get_lyrics(title, artist=None) -直接获取歌曲的歌词
  • get_artist_songs(artist_identifier, per_page=20, sort="popularity") -获取艺术家的歌曲
  • get_artist_albums(artist_identifier) -获取艺术家的专辑
  • get_album_tracks(album_identifier) -按专辑ID或名称从专辑中获取曲目

许可证

麻省理工学院