Gen AI Lyrics Search Agent

Gen AI Lyrics Search Agent

site icon
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 (可选)

安装教程

  1. 克隆仓库:
git clone <repository-url>
cd lyrics-search-agent
  1. 使用Poetry安装依赖:
poetry install
  1. 设置环境变量:
cp .env.example .env
# 编辑.env文件配置
  1. 运行应用:
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

许可证

该项目遵循 None 开源许可条款。