Cover image
Try Now
2025-04-14

3 years

Works with Finder

0

Github Watches

0

Github Forks

0

Github Stars

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

相关推荐

  • av
  • Ejecute sin esfuerzo LLM Backends, API, frontends y servicios con un solo comando.

  • 1Panel-dev
  • 🔥 1Panel proporciona una interfaz web intuitiva y un servidor MCP para administrar sitios web, archivos, contenedores, bases de datos y LLM en un servidor de Linux.

  • WangRongsheng
  • 🧑‍🚀 全世界最好的 llM 资料总结(数据处理、模型训练、模型部署、 O1 模型、 MCP 、小语言模型、视觉语言模型) | Resumen de los mejores recursos del mundo.

  • rulego
  • ⛓️Rulego es un marco de motor de regla de orquestación de componentes de alta generación de alto rendimiento, de alto rendimiento y de alto rendimiento para GO.

  • sigoden
  • Cree fácilmente herramientas y agentes de LLM utilizando funciones Plain Bash/JavaScript/Python.

  • hkr04
  • SDK liviano C ++ MCP (Protocolo de contexto del modelo)

  • RockChinQ
  • 😎简单易用、🧩丰富生态 - 大模型原生即时通信机器人平台 | 适配 Qq / 微信(企业微信、个人微信) / 飞书 / 钉钉 / Discord / Telegram / Slack 等平台 | 支持 Chatgpt 、 Deepseek 、 DiFy 、 Claude 、 Gemini 、 Xai 、 PPIO 、 Ollama 、 LM Studio 、阿里云百炼、火山方舟、 Siliconflow 、 Qwen 、 Moonshot 、 Chatglm 、 SillyTraven 、 MCP 等 LLM 的机器人 / Agente | Plataforma de bots de mensajería instantánea basada en LLM, admite Discord, Telegram, WeChat, Lark, Dingtalk, QQ, Slack

  • dmayboroda
  • Trapo conversacional local con contenedores configurables

  • evilsocket
  • El kit de desarrollo de agentes simples.

  • modelscope
  • Iniciar aplicaciones de múltiples agentes empoderadas con Building LLM de manera más fácil.

    Reviews

    3.4 (7)
    Avatar
    user_AJK3oVjv
    2025-04-24

    As a dedicated user of the mcp-server by tehmenghai, I can confidently say this server application is a game-changer. It's reliable, user-friendly, and highly efficient for managing my server needs. The welcome information is clear, and the documentation provided at the start URL is incredibly helpful. Whether you're a beginner or an expert, this tool is essential for seamless server management. Highly recommended!

    Avatar
    user_utlJLTqY
    2025-04-24

    The mcp-server by tehmenghai is an exceptional tool for server management. Its intuitive interface and robust functionality make it indispensable for both beginners and advanced users. The seamless integration and comprehensive documentation ensure a smooth experience, enhancing productivity. Highly recommend!

    Avatar
    user_PGMMXgP2
    2025-04-24

    The mcp-server by tehmenghai is an outstanding application for managing server tasks efficiently. Its user-friendly interface and robust functionality make it an essential tool for any network administrator. The seamless integration and comprehensive features have significantly optimized our workflow. Highly recommend!

    Avatar
    user_I55xGN4I
    2025-04-24

    As a dedicated user of mcp-server, I am thoroughly impressed with its reliability and performance. Created by the talented tehmenghai, this server application has streamlined my workflow and provided a robust solution for my needs. The intuitive interface and comprehensive documentation make it incredibly user-friendly, even for those newer to server management. Overall, mcp-server is an exceptional product that I highly recommend to anyone looking for a dependable and efficient server application.

    Avatar
    user_Q87qafzI
    2025-04-24

    As a dedicated user of mcp-server by tehmenghai, I can confidently say this tool has significantly optimized my server management tasks. The intuitive interface and reliable performance stand out, making it an invaluable resource. Highly recommend for anyone looking to streamline their server operations!

    Avatar
    user_zm8Dwm1T
    2025-04-24

    As a dedicated user of mcp-server by Tehmenghai, I find it incredibly efficient and reliable for managing my server tasks. The setup is straightforward, and the user-friendly interface makes server management a breeze. Highly recommend it to anyone in need of a robust server solution.

    Avatar
    user_69bgYxpd
    2025-04-24

    As a dedicated user of mcp-server by tehmenghai, I can't say enough about its efficiency and user-friendliness. The seamless integration and robust performance have significantly improved my workflow. The detailed welcome information and intuitive starting URL make onboarding a breeze. Highly recommended for anyone seeking a reliable server solution!