BirdNet-Pi MCP Server

BirdNet-Pi MCP Server

与BirdNet-Pi集成的本地模型上下文协议服务器。

GitHub
Created ByDMontgomery40DMontgomery40

概述

BirdNet-Pi MCP 服务器是一个 Python 应用，使用 Model Context Protocol 提供鸟类检测数据分析功能。

安装步骤

# 克隆仓库
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: 默认 'data/detections.json'
  • BIRDNET_AUDIO_DIR: 默认 'data/audio'
  • BIRDNET_REPORT_DIR: 默认 'data/reports'

启动服务器

python server.py

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

API 功能

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

API 端点

  • GET /functions - 列出可用功能
  • POST /invoke - 调用功能

系统要求

  • Python 3.8+
  • FastAPI 和 Uvicorn
  • 其他依赖见 requirements.txt