Birdnet Pi

🚀 鳥類ネットワークPi MCPサーバー

このサーバーはPythonベースのモデルコンテキストプロトコル（MCP）サーバーで、鳥類ネットワークPiの統合に使用されます。

🚀 クイックスタート

このサーバーを使用することで、鳥類の検出データを日付や種に基づいてフィルタリングして取得したり、検出統計情報や分析を行ったり、音声録音にアクセスしたりすることができます。

✨ 主な機能

• 日付と種に基づいて鳥類検出データをフィルタリングして検索
• 検出統計情報の取得と分析
• 音声録音へのアクセス
• 日々の活動パターンの取得
• レポートの生成

📦 インストール

1. リポジトリをクローンする

git clone https://github.com/YourUsername/mcp-server.git
cd mcp-server

2. 仮想環境を作成してアクティブ化する

python -m venv venv
source venv/bin/activate  # Windowsの場合は：venv\Scripts\activate

3. 依存関係をインストールする

pip install -r requirements.txt

4. データディレクトリを設定する

mkdir -p data/audio data/reports

📚 ドキュメント

設定

サーバーは環境変数を使用して設定できます。

• BIRDNET_DETECTIONS_FILE：検出JSONファイルのパス（デフォルト：'data/detections.json'）
• BIRDNET_AUDIO_DIR：音声ファイルディレクトリのパス（デフォルト：'data/audio'）
• BIRDNET_REPORT_DIR：レポートディレクトリのパス（デフォルト：'data/reports'）

サーバーの起動

python server.py

サーバーはhttp://localhost:8000で起動します。

APIエンドポイント

• /functions - 利用可能な関数をリストする（GET）
• /invoke - 関数を呼び出す（POST）

利用可能な関数

1. getBirdDetections
   • 日付範囲と種でフィルタリングされた鳥類検出データを取得
   • パラメータ：startDate，endDate，species（オプション）
2. getDetectionStats
   • 指定された期間の検出統計情報を取得
   • パラメータ：period（'day'，'week'，'month'，'all'），minConfidence（オプション）
3. getAudioRecording
   • 検出された音声録音を取得
   • パラメータ：filename，format（'base64'または'buffer'）
4. getDailyActivity
   • 特定の日付の鳥類の活動パターンを取得
   • パラメータ：date，species（オプション）
5. generateDetectionReport
   • 検出レポートを生成
   • パラメータ：startDate，endDate，format（'html'または'json'）

ディレクトリ構造

mcp-server/
├── birdnet/
│   ├── __init__.py
│   ├── config.py
│   ├── functions.py
│   └── utils.py
├── data/
│   ├── audio/
│   └── reports/
├── server.py
├── requirements.txt
└── README.md