Birdstats

🚀 mcp-server-birdstats

Compare your BirdNET-Pi data with eBird observations using a natural language interface.

🚀 Quick Start

This MCP plugin allows you to analyze BirdNET-Pi/BirdWeather detection data by connecting to eBird's vast database.

✨ Features

• A natural language interface for querying birdnet-pi / birdweather and eBird data.
• Compare BirdWeather detections with eBird observations.
• Data-driven visualizations implemented using React components.

📦 Installation

1. Clone the repository:

git clone https://github.com/yourusername/mcp-server-birdstats.git

2. Install dependencies:

npm install

Claude Configuration

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

💻 Usage Examples

Basic Usage

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

• "My BirdNET heard a Grey-bellied Falcon — is that unusual?"
• "What was the rarest detection at my station this week?"
• "Generate a chart of my detections by time."
• "Have others seen these Wood Warblers on eBird?"

🔧 Technical Details

Data Integrity

This plugin strictly adheres to data integrity principles:

• Only uses actual API response data.
• Never creates sample or estimated data.
• Always displays the number and percentage of observations.
• Clearly indicates when no data is available.

Core Logic

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

• BirdWeather API interactions.
• eBird API interactions.
• Data analysis functions.
• Type definitions.
• Utility helper functions.

API Integration

BirdWeather API

• Site statistics.
• Species lists.
• Detection records.

eBird API

• Recent observations.
• Notable observation records.
• Hotspot data.
• Species information.

📄 License

MIT

💡 Usage Tip

If you need to report an issue or request a feature, please open an issue in the GitHub repository.