AI导哈

歌词搜索AI代理

一个生成式AI代理，能够在网络上搜索歌曲歌词并以特定格式返回结果，适用于移动应用。

  • by tehmenghai
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 tehmenghai/mcp-server

使用说明

Gen AI歌词搜索代理

一个生成式人工智能代理，可以在网络上搜索歌词，并以特定格式返回移动应用程序的结果。采用模型上下文协议（MCP）构建，用于标准化工具集成。

特性

  • 🔍 跨多个来源的基于网络的歌词搜索
  • 🤖 生成式人工智能对话界面
  • 🔌 MCP兼容工具集成
  • 🚀 基于FastAPI的REST API
  • 🔒 身份验证和速率限制
  • 📊 性能监控和分析

先决条件

  • Python 3.10或更高版本
  • 依赖管理诗
  • Docker（可选）

设置

  1. 克隆存储库：
git clone <repository-url>
cd lyrics-search-agent
  1. 使用Poetry安装依赖项：
poetry install
  1. 设置环境变量：
cp .env.example .env
# Edit .env with your configuration
  1. 运行应用程序：
poetry run uvicorn app.main:app --reload

或者使用Docker：

docker build -t lyrics-search-agent .
docker run -p 8000:8000 lyrics-search-agent

API文档

应用程序运行后，请访问：

  • API文件：http://localhost:8000/docs
  • ReDoc替代方案：http://localhost:8000/redoc

关键终点

  • GET /：服务信息
  • POST /search：搜索歌词
  • GET /tools：列出可用工具

发展

项目结构

app/
├── __init__.py
├── main.py
├── mcp/
│   ├── __init__.py
│   └── protocol.py
└── tools/
    └── web_search.py

添加新工具

  1. 在中创建新的工具类 app/tools/
  2. 实施 BaseTool 接口
  3. 在中注册该工具 app/main.py

测试

使用pytest运行测试：

poetry run pytest

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 提交您的更改
  4. 推到分支
  5. 创建拉取请求

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

致谢

  • OpenAI/Anthropic用于LLM功能
  • web框架的FastAPI
  • LangChain用于LLM编排

相关 MCP