mcp-server

# 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: ```bash git clone <repository-url> cd lyrics-search-agent ``` 2. Install dependencies using Poetry: ```bash poetry install ``` 3. Set up environment variables: ```bash cp .env.example .env # Edit .env with your configuration ``` 4. Run the application: ```bash poetry run uvicorn app.main:app --reload ``` Or using Docker: ```bash 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: ```bash 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