mcpField
G
Gen AI Lyrics Search Agent

Gen AI Lyrics Search Agent

ローカル
github.com/tehmenghaiAI・エージェント179 週間前に更新
リポジトリ

Gen AI Lyrics Search Agent について

Gen AI Lyrics Search Agent は、ウェブ上の複数の情報源から歌詞を探し、指定形式で返すモバイルアプリ向けエージェントです。MCP によるツール連携と FastAPI の REST API を備えています。

主な機能

  1. 01ウェブ上の複数ソースから歌詞検索
  2. 02生成 AI による会話インターフェース
  3. 03FastAPI REST API
  4. 04認証とレート制限
  5. 05パフォーマンス監視と分析

活用シーン

  1. 01モバイルアプリ向けの歌詞取得
  2. 02会話による歌詞検索
  3. 03歌詞検索サービスの性能監視

MCP 対応

標準化されたツール連携に MCP を採用し、MCP クライアントから歌詞検索機能を利用できます。

#gen-ai#lyrics-search#music-assistant

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "tehmenghai": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "build"
      ]
    }
  }
}
起動コマンドdocker run -i --rm build

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
ocibuild

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

生成 AI 歌詞検索エージェント

ウェブ全体から歌詞を検索し、モバイルアプリ向けの特定の形式で結果を返す生成 AI エージェントです。標準化されたツール連携のために、Model Context Protocol（MCP）を使用して構築されています。

特長

  • 🔍 複数のソースを対象としたウェブベースの歌詞検索
  • 🤖 生成 AI を活用した会話インターフェース
  • 🔌 MCP 準拠のツール連携
  • 🚀 FastAPI ベースの REST API
  • 🔒 認証とレート制限
  • 📊 パフォーマンスの監視と分析

前提条件

  • Python 3.10 以降
  • 依存関係の管理に使用する Poetry
  • 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 ドキュメント

アプリケーションの実行後、以下にアクセスします：

主なエンドポイント
  • 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. Pull Request を作成します

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については LICENSE ファイルを参照してください。

謝辞

  • LLM 機能を提供する OpenAI/Anthropic
  • ウェブフレームワークを提供する FastAPI
  • LLM のオーケストレーションを行う LangChain

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。