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
  • 毫不费力地使用一个命令运行LLM后端,API,前端和服务。

  • 1Panel-dev
  • 🔥1Panel提供了直观的Web接口和MCP服务器,用于在Linux服务器上管理网站,文件,容器,数据库和LLMS。

  • WangRongsheng
  • 🧑‍🚀 llm 资料总结(数据处理、模型训练、模型部署、 o1 模型、mcp 、小语言模型、视觉语言模型)|摘要世界上最好的LLM资源。

  • rulego
  • ⛓️Rulego是一种轻巧,高性能,嵌入式,下一代组件编排规则引擎框架。

  • sigoden
  • 使用普通的bash/javascript/python函数轻松创建LLM工具和代理。

  • hkr04
  • 轻巧的C ++ MCP(模型上下文协议)SDK

  • RockChinQ
  • 😎简单易用、🧩丰富生态 -大模型原生即时通信机器人平台| 适配QQ / 微信(企业微信、个人微信) /飞书 /钉钉 / discord / telegram / slack等平台| 支持chatgpt,deepseek,dify,claude,基于LLM的即时消息机器人平台,支持Discord,Telegram,微信,Lark,Dingtalk,QQ,Slack

  • dmayboroda
  • 带有可配置容器的本地对话抹布

  • paulwing
  • 使用MCP服务创建的测试存储库

    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!