Gen AI Lyrics Search Agent

A generative AI agent that can search for song lyrics across the web and return results in a specific format for mobile apps. Built with Model Context Protocol (MCP) for standardized tool integration.

Features

• 🔍 Web-based lyrics search across multiple sources
• 🤖 Generative AI-powered conversation interface
• 🔌 MCP-compliant tool integration
• 🚀 FastAPI-based REST API
• 🔒 Authentication and rate limiting
• 📊 Performance monitoring and analytics

Prerequisites

• Python 3.10 or higher
• Poetry for dependency management
• Docker (optional)

Setup

1. Clone the repository:

git clone <repository-url>
cd lyrics-search-agent

2. Install dependencies using Poetry:

poetry install

3. Set up environment variables:

cp .env.example .env
# Edit .env with your configuration

4. Run the application:

poetry run uvicorn app.main:app --reload

Or using Docker:

docker build -t lyrics-search-agent .
docker run -p 8000:8000 lyrics-search-agent

API Documentation

Once the application is running, visit:

• API documentation: http://localhost:8000/docs
• ReDoc alternative: http://localhost:8000/redoc

Key Endpoints

• GET /: Service information
• POST /search: Search for lyrics
• GET /tools: List available tools

Development

Project Structure

app/
├── __init__.py
├── main.py
├── mcp/
│   ├── __init__.py
│   └── protocol.py
└── tools/
    └── web_search.py

Adding New Tools

1. Create a new tool class in app/tools/
2. Implement the BaseTool interface
3. Register the tool in app/main.py

Testing

Run tests using pytest:

poetry run pytest

Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• OpenAI/Anthropic for LLM capabilities
• FastAPI for the web framework
• LangChain for LLM orchestration