MCP Camera Feeds 🦈🐧🐋

A Model Context Protocol (MCP) server that lets Claude take live snapshots from Georgia Aquarium webcams, analyze what it sees, and log observations over time.

Cameras

ID	Camera	View
ocean-voyager	Ocean Voyager (whale sharks, mantas)	Underwater
beluga-whale	Beluga Whale Cam	Underwater
african-penguin	African Penguin Cam	Above-water habitat
sharks-predators	Sharks! Predators of the Deep	Underwater

Tools

Tool	Description
take_snapshot	Capture a live frame from the active camera + return species info
switch_camera	Switch to a different camera
list_cameras	List all cameras and which is active
make_observation	Save a timestamped note with optional tags
get_observations	Retrieve past observations

Setup

Requirements: Node.js 18+

npm install
npx playwright install chromium
npm run build

Connecting to Claude

Claude Code

claude mcp add aquarium-cameras node "/path/to/dist/index.js"

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "aquarium-cameras": {
      "command": "node",
      "args": ["/path/to/dist/index.js"]
    }
  }
}

Adding More Cameras

Add entries to src/cameras.ts — each camera needs an id, name, url, description, and info block. Optional fields:

• bufferMs — extra load time for slow streams (default: 5000ms)
• clickToPlay — set true if the stream needs a click to start

Then npm run build and restart Claude.

Development

npm run dev   # run with tsx (no build step)
npm run build # compile TypeScript
npm start     # run compiled output