Skip to Content
MCP ServersCommunitymcp-server-birdstats

mcp-server-birdstats

View original on GitHub 

Cross-reference your BirdNET-Pi data with eBird observations using natural language

Overview

This MCP plugin allows you to analyze BirdNET-Pi/BirdWeather detections by connecting them with eBird’s extensive database.

Features

  • Natural language interface for querying birdnet-pi / birdweather, and eBird data
  • Cross-reference BirdWeather detections with eBird observations
  • Data-driven visualizations with React artifacts

Installation

  1. Clone the repository:
git clone https://github.com/yourusername/mcp-server-birdstats.git
  1. Install dependencies:
npm install

Claude Config

"mcp-birdstats": { "command": "npx", "args": ["-y", "mcp-birdstats"] },

Usage

The plugin processes natural language queries about your bird detection data. Example queries:

  • β€œMy BirdNET heard a Swainson’s Thrush - is that unusual?”
  • β€œWhat’s my station’s rarest detection this week?”
  • β€œGraph my detections by time of day”
  • β€œAre others seeing these warblers on eBird?”

Data Integrity

This plugin strictly adheres to data integrity principles:

  • Only uses actual API response data
  • Never creates example or estimated data
  • Always shows observation counts with percentages
  • Clear indication when data is unavailable

Core Logic

The core functionality is contained in a single text file under src/index.txt which includes:

  • BirdWeather API interactions
  • eBird API interactions
  • Data analysis functions
  • Type definitions
  • Helper utilities

API Integration

BirdWeather API

  • Station statistics
  • Species lists
  • Detection records

eBird API

  • Recent observations
  • Notable sightings
  • Hotspot data
  • Species information

License

MIT

Support

For issues and feature requests, please open an issue on the GitHub repository.

Last updated on