What is Mcp Server Birdstats

mcp-server-birdstats is a plugin that allows users to analyze BirdNET-Pi and BirdWeather detections by cross-referencing them with eBird observations using natural language queries.

Use cases

Use cases include analyzing bird detection trends, comparing local observations with eBird data, and generating visual reports on bird activity.

How to use

To use mcp-server-birdstats, clone the repository, install the dependencies, and configure it in your application. You can then query your bird detection data using natural language, such as asking about unusual sightings or visualizing detections over time.

Key features

Key features include a natural language interface for querying data, cross-referencing BirdWeather detections with eBird observations, and data-driven visualizations using React.

Where to use

mcp-server-birdstats can be used in fields such as ornithology, wildlife research, and environmental monitoring, where bird detection and observation data are relevant.

mcp-server-birdstats

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

2. 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.