hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Integrations
Used as the web framework for implementing the MCP server's API endpoints for bird detection data.
Used for version control and distribution of the MCP server codebase.
Hosts the repository for the MCP server code, enabling collaboration and distribution.
BirdNet-Pi MCP サーバー
BirdNet-Pi 統合用の Python ベースのモデル コンテキスト プロトコル (MCP) サーバー。
特徴
- 日付と種のフィルタリングによる鳥類検出データの取得
- 検出統計と分析
- 音声録音アクセス
- 日常の活動パターン
- レポート生成
要件
- Python 3.8以上
- ファストAPI
- ウビコーン
requirements.txtに記載されているその他の依存関係
インストール
- リポジトリをクローンします。
Copy
- 仮想環境を作成してアクティブ化します。
Copy
- 依存関係をインストールします:
Copy
- データ ディレクトリを設定します。
Copy
構成
サーバーは環境変数を使用して設定できます。
BIRDNET_DETECTIONS_FILE: 検出JSONファイルへのパス（デフォルト: 'data/detections.json'）BIRDNET_AUDIO_DIR: オーディオファイルディレクトリへのパス（デフォルト: 'data/audio'）BIRDNET_REPORT_DIR: レポートディレクトリへのパス（デフォルト: 'data/reports'）
サーバーの実行
サーバーを起動します。
Copy
サーバーはhttp://localhost:8000で実行されます。
APIエンドポイント
/functions- 利用可能な関数の一覧を表示する (GET)/invoke- 関数を呼び出す (POST)
利用可能な機能
getBirdDetections- 日付範囲と種でフィルタリングされた鳥の検出を取得します
- パラメータ: startDate、endDate、species（オプション）
getDetectionStats- 一定期間の検出統計を取得する
- パラメータ: period ('day', 'week', 'month', 'all'), minConfidence (オプション)
getAudioRecording- 検出のための音声録音を取得する
- パラメータ: ファイル名、形式 ('base64' または 'buffer')
getDailyActivity- 特定の日の鳥の活動パターンを取得する
- パラメータ: 日付、種（オプション）
generateDetectionReport- 検出レポートを生成する
- パラメータ: startDate、endDate、format ('html' または 'json')
ディレクトリ構造
Copy
This server cannot be installed
モデル コンテキスト プロトコルを介して鳥類検出データにアクセスして分析できる Python ベースのサーバー。検出のフィルタリング、音声録音へのアクセス、レポートの生成などの機能を提供します。