Dmontgomery40 MCP Local Server

🚀 鳥網Pi MCP服務器

鳥網Pi MCP服務器是一個基於Python的模型上下文協議（MCP）服務器，專為鳥網Pi集成而設計。它能助力用戶過濾檢索鳥類檢測數據、開展檢測統計分析、訪問音頻錄音等，為鳥類研究和監測提供有力支持。

🚀 快速開始

本服務器是基於Python的模型上下文協議（MCP）服務器，用於鳥網Pi的集成。以下是使用前的準備步驟。

✨ 主要特性

• 數據過濾檢索：可根據日期和物種過濾檢索鳥類檢測數據。
• 檢測統計分析：提供檢測統計和分析功能。
• 音頻錄音訪問：支持對檢測的音頻錄音進行訪問。
• 日活動模式分析：能獲取特定日期的鳥類活動模式。
• 報告生成：可生成檢測報告。

📦 安裝指南

克隆倉庫

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

創建並激活虛擬環境

python -m venv venv
source venv/bin/activate  # 在Windows上使用：venv\Scripts\activate

安裝依賴項

pip install -r requirements.txt

設置數據目錄

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