BirdNet-Pi MCP 服务器
用于 BirdNet-Pi 集成的基于 Python 的模型上下文协议 (MCP) 服务器。
特征
- 通过日期和物种过滤检索鸟类检测数据
- 检测统计与分析
- 录音访问
- 日常活动模式
- 报告生成
要求
- Python 3.8+
- 快速API
- 优维康
requirements.txt
中列出的其他依赖项
安装
- 克隆存储库:
git clone https://github.com/YourUsername/mcp-server.git
cd mcp-server
- 创建虚拟环境并激活它:
python -m venv venv
source venv/bin/activate # On Windows use: 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')
运行服务器
启动服务器:
服务器将在http://localhost:8000
上运行。
API 端点
/functions
列出可用函数(GET)/invoke
– 调用函数(POST)
可用函数
getBirdDetections
- 获取按日期范围和物种筛选的鸟类检测结果
- 参数:startDate、endDate、种类(可选)
getDetectionStats
- 获取一段时间内的检测统计数据
- 参数:period('day', 'week', 'month', 'all')、minConfidence(可选)
getAudioRecording
- 获取检测的音频记录
- 参数:文件名,格式('base64'或'buffer')
getDailyActivity
- 获取特定日期的鸟类活动模式
- 参数:日期、物种(可选)
generateDetectionReport
- 生成检测报告
- 参数:startDate、endDate、格式('html' 或 'json')
目录结构
mcp-server/
├── birdnet/
│ ├── __init__.py
│ ├── config.py
│ ├── functions.py
│ └── utils.py
├── data/
│ ├── audio/
│ └── reports/
├── server.py
├── requirements.txt
└── README.md