BirdNet-Pi MCP 服务器

用于 BirdNet-Pi 集成的基于 Python 的模型上下文协议 (MCP) 服务器。

特征

通过日期和物种过滤检索鸟类检测数据
检测统计与分析
录音访问
日常活动模式
报告生成

Related MCP server: eBird MCP Server

要求

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'）

运行服务器

启动服务器：

python server.py

服务器将在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