BirdNet-Pi MCP Server

@MCP-Mirror

About BirdNet-Pi MCP Server

Mirror of

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "DMontgomery40_mcp-local-server": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is BirdNet-Pi MCP Server?

BirdNet-Pi MCP Server is a Python-based Model Context Protocol server that integrates with BirdNet-Pi to provide bird detection data retrieval, statistics, audio recording access, and report generation. It is designed for users who want to programmatically access BirdNet‑Pi detection data via a REST API.

How to use BirdNet-Pi MCP Server?

Install dependencies from requirements.txt, set environment variables for the detection file, audio, and report directories, and run python server.py to start the server on http://localhost:8000. Use the /functions endpoint to list available functions and /invoke to call functions such as getBirdDetections and generateDetectionReport.

Key features of BirdNet-Pi MCP Server

Bird detection data retrieval with date and species filtering
Detection statistics and analysis
Audio recording access
Daily activity patterns
Report generation (HTML or JSON)

Use cases of BirdNet-Pi MCP Server

Extract bird detection records filtered by date range and species
Analyze detection statistics over daily, weekly, monthly, or all‑time periods
Download audio recordings of detected birds
Visualize daily bird activity patterns for a specific date
Generate detection reports in HTML or JSON format

FAQ from BirdNet-Pi MCP Server

What Python and dependencies are required?

Python 3.8 or later, with FastAPI, Uvicorn, and other dependencies listed in requirements.txt.

How is the server configured?

Configuration is done via environment variables: BIRDNET_DETECTIONS_FILE (default data/detections.json), BIRDNET_AUDIO_DIR (default data/audio), and BIRDNET_REPORT_DIR (default data/reports).

How do I start the BirdNet-Pi MCP Server?

Run python server.py from the project directory; the server runs on `http://localhost:8000

Frequently asked questions

What Python and dependencies are required?

Python 3.8 or later, with FastAPI, Uvicorn, and other dependencies listed in `requirements.txt`.

How is the server configured?

Configuration is done via environment variables: `BIRDNET_DETECTIONS_FILE` (default `data/detections.json`), `BIRDNET_AUDIO_DIR` (default `data/audio`), and `BIRDNET_REPORT_DIR` (default `data/reports`).