MCP Local Server

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

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

🚀 クイックスタート

このサーバは、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

📚 ドキュメント

設定

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

サーバの起動

サーバを起動するには、以下のコマンドを実行します：

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