BirdNet-Pi MCP Server

BirdNet-Pi MCP Server

镜像

概述

BirdNet-Pi MCP 服务器是一个用于鸟类检测数据检索和分析的 Python 工具,支持按日期和物种筛选、统计分析、音频访问和报告生成等功能。

安装步骤

# 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: 检测数据文件路径
  • BIRDNET_AUDIO_DIR: 音频文件目录
  • BIRDNET_REPORT_DIR: 报告存储目录

启动服务器

python server.py

服务器将在 http://localhost:8000 运行

主要功能

功能描述参数
getBirdDetections获取鸟类检测数据startDate, endDate, species(可选)
getDetectionStats获取检测统计period, minConfidence(可选)
getAudioRecording获取音频记录filename, format
getDailyActivity获取日活动模式date, species(可选)
generateDetectionReport生成检测报告startDate, endDate, format

API 使用

  • 获取可用功能: GET /functions
  • 调用功能: POST /invoke

示例:获取检测数据

{
  "name": "getBirdDetections",
  "parameters": {
    "startDate": "2023-10-01",
    "endDate": "2023-10-07",
    "species": "American Robin"
  }
}

需要详细信息,请参考完整文档。