Repository avatar
Other Tools
v0.2.5
active

birdweather-mcp

io.github.pfrederiksen/birdweather-mcp

MCP server for BirdWeather station detections, species, and stats.

Documentation

birdweather-mcp

Ask your AI about the birds your station is hearing — detections, species, and stats via MCP.

MIT License Python 3.11+ PyPI MCP compatible Docker ready

birdweather-mcp

Self-hostable MCP server for BirdWeather. Point Claude, Cursor, or any MCP client at your (or any public) station and ask natural-language questions about what was detected, what’s trending, and what’s nearby.

Works out of the box against the public GraphQL API — no account required. Optionally set a station token for richer REST fields. The token is never logged or echoed.

Features

  • 15 MCP tools — station info, counts, weather, detections, top species, daily series, species trends, new arrivals, station compare, hourly activity, species search/profiles, nearby stations
  • Prompts & resources — daily/weekly summaries, species deep-dives, and birdweather://station/… URIs
  • No auth required for public GraphQL; optional BIRDWEATHER_STATION_TOKEN for REST
  • stdio (Claude Desktop / Cursor) or streamable-HTTP (Docker / Synology / Tailscale)
  • Token-safe — redacted in logs and errors (SECURITY.md)
  • Docker + compose — prebuilt multi-arch images on GHCR (ghcr.io/pfrederiksen/birdweather-mcp)

Quickstart

uvx (no clone):

uvx birdweather-mcp

pip / pipx:

pip install birdweather-mcp
# or: pipx install birdweather-mcp
birdweather-mcp

Homebrew:

brew install pfrederiksen/tap/birdweather-mcp
birdweather-mcp

Docker (stdio):

docker pull ghcr.io/pfrederiksen/birdweather-mcp:latest
docker run --rm -i ghcr.io/pfrederiksen/birdweather-mcp:latest

Long-lived HTTP on a NAS → Self-hosting. More install paths → Installation. Python / MCP SDK notes → Requirements & compatibility.

Configure Claude Desktop / Cursor / VS Code → Clients.

Documentation

GuideDescription
docs/README.mdIndex of all guides
Installationuvx, pip, pipx, Homebrew, Docker/GHCR, from source
ConfigurationEnvironment variables, station ID/token
ClientsClaude Desktop, Cursor, Claude Code, VS Code, HTTP
ToolsTools, prompts, and resources
Self-hostingDocker, Synology/arm64, LAN/Tailscale, updates
DevelopmentDev setup, tests, lint, release process
TroubleshootingCommon problems and FAQ

Demo

Demo conversation about Example Station 12345

Placeholder illustration of asking an MCP client about Example Station (12345) — not live data.

License

Licensed under MIT. See also CHANGELOG.md, CONTRIBUTING.md, and SECURITY.md.

PYPI
birdweather-mcp
Install Command
pip install birdweather-mcp
Runtime: uvx
OCI
ghcr.io/pfrederiksen/birdweather-mcp:0.2.5
Install Command
docker pull ghcr.io/pfrederiksen/birdweather-mcp:0.2.5:undefined