mcpField
G
Gen AI Lyrics Search Agent

Gen AI Lyrics Search Agent

Local
github.com/tehmenghaiAI & Agents1Updated 79w ago
Repository

About Gen AI Lyrics Search Agent

Gen AI Lyrics Search Agent is a lyrics-search agent for mobile apps, finding songs across web sources and returning results in a specified format. It combines MCP tool integration with a FastAPI REST API.

Key features

  1. 01Search lyrics across web sources
  2. 02Generative AI conversation interface
  3. 03FastAPI REST API
  4. 04Authentication and rate limiting
  5. 05Performance monitoring and analytics

Use cases

  1. 01Retrieve lyrics for mobile apps
  2. 02Find lyrics through conversation
  3. 03Monitor lyrics service performance

MCP support

The service uses MCP for standardized tool integration, allowing MCP clients to access its lyrics-search capability.

#gen-ai#lyrics-search#music-assistant

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "tehmenghai": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "build"
      ]
    }
  }
}
Run commanddocker run -i --rm build

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
ocibuild

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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
  1. Install dependencies using Poetry:
poetry install
  1. Set up environment variables:
cp .env.example .env
# Edit .env with your configuration
  1. 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:

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.