BirdStats
About
Integrates BirdNET-Pi and eBird APIs to enable cross-referencing bird detection data with observation records for ecological research and bird watching insights.
Details
- Author
- dmontgomery40
- Repository
- DMontgomery40/mcp-server-birdstats
- GitHub stars
- 1
- Downloads
- 366
- License
- MIT License
- Categories
- AI, Design, Developer Tools, Search, Infrastructure, Knowledge Base, API
Jump to
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
BirdStatsCommand (node, npx, python, etc.)npmArguments-
Argument 1
run -
Argument 2
start
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
npm install
npm run build
get_system_prompt
Retrieve the system prompt used for interactions. No parameters required.
get_birdweather_api
Access the BirdWeather API for weather-related data. No parameters required.
get_ebird_api
Access the eBird API for bird observation data. No parameters required.
check-bird
A prompt to analyze bird-related data. No parameters specified.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"birdstats": {
"cwd": "optional",
"env": {},
"args": [
"run",
"start"
],
"shell": false,
"command": "npm"
}
}
}Linux
{
"cwd": "optional",
"env": [],
"args": [
"run",
"start"
],
"shell": false,
"command": "npm"
}Macos
{
"cwd": "optional",
"env": [],
"args": [
"run",
"start"
],
"shell": false,
"command": "npm"
}Windows
{
"cwd": "optional",
"env": [],
"args": [
"/c",
"npm run start"
],
"shell": false,
"command": "cmd"
}mcp-server-birdstats
MCP server that exposes BirdWeather and eBird analysis context for code-execution and chat clients.
What This Server Provides
This server focuses on three read-only tools and one analysis prompt:
- get_system_prompt
- get_birdweather_api
- get_ebird_api
- check-bird prompt
The tools are intentionally optimized for low-token defaults:
- Default mode is summary.
- Full payload access requires mode="full" and confirmLargePayload=true.
- Tool failures return structured errors (status, retryable, suggestion, message) to help clients self-correct.
Requirements
- Node.js 18+
- npm
Install
npm install
npm run build
Run
stdio (default)
npm run start
or explicitly:
npm run start:stdio
Streamable HTTP
MCP_TRANSPORT=streamable-http \
MCP_HTTP_HOST=127.0.0.1 \
MCP_HTTP_PORT=3000 \
MCP_HTTP_PATH=/mcp \
npm run start
Optional hardening:
- MCP_ALLOWED_ORIGINS=http://localhost,http://127.0.0.1:3000
If an Origin header is present and not allowed, the server returns 403.
Docker
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
