BirdNet-Pi MCP Server

基本能力

产品定位

BirdNet-Pi MCP Server 是一个专门为 BirdNet-Pi 设计的 MCP 服务器，用于处理和分析鸟类检测数据。

核心功能

• 鸟类检测数据检索：支持按日期和物种过滤检索检测数据。
• 检测统计和分析：提供检测数据的统计分析功能。
• 音频记录访问：可以访问和获取检测到的鸟类音频记录。
• 日常活动模式：分析特定日期的鸟类活动模式。
• 报告生成：生成检测报告的 HTML 或 JSON 格式。

适用场景

• 生态研究和鸟类观察
• 数据分析和报告生成
• 音频记录管理和访问

工具列表

• getBirdDetections：获取按日期和物种过滤的鸟类检测数据。
• getDetectionStats：获取检测数据的统计分析。
• getAudioRecording：获取检测到的鸟类音频记录。
• getDailyActivity：分析特定日期的鸟类活动模式。
• generateDetectionReport：生成检测报告。

常见问题解答

• 如何配置服务器？：通过环境变量配置数据文件和目录路径。
• 如何启动服务器？：运行 python server.py 命令启动服务器。
• 如何访问 API？：服务器运行在 http://localhost:8000，可通过 /functions 和 /invoke 端点访问。

使用教程

使用依赖

• Python 3.8+
• FastAPI
• Uvicorn
• 其他依赖项（见 requirements.txt）

安装教程

1. 克隆仓库：

git clone https://github.com/YourUsername/mcp-server.git
cd mcp-server

1. 创建并激活虚拟环境：

python -m venv venv
source venv/bin/activate  # Windows 用户使用：venv\Scripts\activate

1. 安装依赖：

pip install -r requirements.txt

1. 设置数据目录：

mkdir -p data/audio data/reports

调试方式

1. 启动服务器：

python server.py

1. 访问 http://localhost:8000 进行调试。

许可证

None