MCP Server Birdstats

🚀 mcp-server-birdstats

Cross - check BirdNET - Pi data with eBird observations using natural language.

🚀 Quick Start

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

✨ Features

• Provide a natural language interface for querying birdnet - pi/birdweather data and eBird data.
• Cross - check BirdWeather's detection results with eBird's observation records.
• A data - based visualization interface 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 handles natural language queries about your bird detection data. Example queries include:

• "My BirdNET heard a Grey - bellied Thrush. Is this unusual?"
• "What was the rarest detection at my site this week?"
• "Show my detections in a chart by time period."
• "Have others seen these warblers on eBird?"

📚 Documentation

Data Integrity

This plugin strictly adheres to the principles of data integrity:

• Only use actual API response data.
• Never create example or estimated data.
• Always display the number of observations and their percentages.
• Clearly indicate when no data is available.

Core Logic

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

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

API Integration

BirdWeather API

• Site statistics
• Species list
• Detection records

eBird API

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

📄 License

MIT

Support

To report issues or request features, please open an issue in the GitHub repository.