Dmontgomery40 MCP Local Server

🚀 鳥網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