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"
}
}
需要详细信息,请参考完整文档。