
MCP-Server
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
- Clone the repository:
git clone <repository-url>
cd lyrics-search-agent
- Install dependencies using Poetry:
poetry install
- Set up environment variables:
cp .env.example .env
# Edit .env with your configuration
- 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
- Create a new tool class in
app/tools/
- Implement the
BaseTool
interface - Register the tool in
app/main.py
Testing
Run tests using pytest:
poetry run pytest
Contributing
- Fork the repository
- Create a feature branch
- Commit your changes
- Push to the branch
- 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
相关推荐
😎简单易用、🧩丰富生态 -大模型原生即时通信机器人平台| 适配QQ / 微信(企业微信、个人微信) /飞书 /钉钉 / discord / telegram / slack等平台| 支持chatgpt,deepseek,dify,claude,基于LLM的即时消息机器人平台,支持Discord,Telegram,微信,Lark,Dingtalk,QQ,Slack
Reviews

user_AJK3oVjv
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!

user_utlJLTqY
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!

user_PGMMXgP2
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!

user_I55xGN4I
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.

user_Q87qafzI
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!

user_zm8Dwm1T
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.

user_69bgYxpd
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!