
Gen AI Lyrics Search Agent

2025.04.22
0
Python歌词搜索生成式AIREST API内容生成
Gen AI Lyrics Search Agent 是一个基于生成式AI的歌词搜索代理,能够通过网络搜索歌曲歌词,并以特定格式返回结果,适用于移动应用。该项目采用Model Context Protocol (MCP) 进行标准化工具集成。
View on GitHub
Overview
基本能力
产品定位
Gen AI Lyrics Search Agent 是一个基于生成式AI的歌词搜索代理,专为移动应用提供标准化的歌词搜索服务。
核心功能
- 🔍 基于网络的歌词搜索,支持多源搜索
- 🤖 生成式AI驱动的对话界面
- 🔌 符合MCP标准的工具集成
- 🚀 基于FastAPI的REST API
- 🔒 认证和速率限制
- 📊 性能监控和分析
适用场景
- 移动应用中的歌词搜索功能
- 音乐相关应用的AI对话界面
- 需要标准化工具集成的歌词服务
工具列表
web_search.py
: 提供网络歌词搜索功能,支持多源搜索和结果格式化。
常见问题解答
- 如何添加新工具?
- 在
app/tools/
目录下创建新工具类 - 实现
BaseTool
接口 - 在
app/main.py
中注册工具
使用教程
使用依赖
- Python 3.10或更高版本
- Poetry 用于依赖管理
- Docker (可选)
安装教程
- 克隆仓库:
git clone <repository-url>
cd lyrics-search-agent
- 使用Poetry安装依赖:
poetry install
- 设置环境变量:
cp .env.example .env
# 编辑.env文件配置
- 运行应用:
poetry run uvicorn app.main:app --reload
或使用Docker:
docker build -t lyrics-search-agent .
docker run -p 8000:8000 lyrics-search-agent
调试方式
- 运行测试:
poetry run pytest
- 访问API文档:
- http://localhost:8000/docs
- http://localhost:8000/redoc