BirdNet-Pi MCP Server

by DMontgomery40
Verified

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Used as the web framework for implementing the MCP server's API endpoints for bird detection data.

  • Used for version control and distribution of the MCP server codebase.

  • Hosts the repository for the MCP server code, enabling collaboration and distribution.

BirdNet-Pi MCP 服务器

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

特征

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

要求

  • Python 3.8+
  • 快速API
  • 优维康
  • requirements.txt中列出的其他依赖项

安装

  1. 克隆存储库:
git clone https://github.com/YourUsername/mcp-server.git cd mcp-server
  1. 创建虚拟环境并激活它:
python -m venv venv source venv/bin/activate # On Windows use: venv\Scripts\activate
  1. 安装依赖项:
pip install -r requirements.txt
  1. 设置数据目录:
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)

可用函数

  1. getBirdDetections
    • 获取按日期范围和物种筛选的鸟类检测结果
    • 参数:startDate、endDate、种类(可选)
  2. getDetectionStats
    • 获取一段时间内的检测统计数据
    • 参数:period('day', 'week', 'month', 'all')、minConfidence(可选)
  3. getAudioRecording
    • 获取检测的音频记录
    • 参数:文件名,格式('base64'或'buffer')
  4. getDailyActivity
    • 获取特定日期的鸟类活动模式
    • 参数:日期、物种(可选)
  5. 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
-
security - not tested
F
license - not found
-
quality - not tested

基于 Python 的服务器,可以通过模型上下文协议访问和分析鸟类检测数据,提供过滤检测、访问录音和生成报告等功能。

  1. Features
    1. Requirements
      1. Installation
        1. Configuration
          1. Running the Server
            1. API Endpoints
              1. Available Functions
            2. Directory Structure
              ID: n6d0knv81q