LyricsGenius MCP Server

这是一个通过LyricsGenius库从Genius.com访问歌曲歌词和艺术家信息的模型上下文协议（MCP）服务器。

特性

• 在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  # 在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或名称获取专辑中的曲目

许可证

MIT