Skip to content
Conduit

mcp server

benny-the-dog-mcp

Benny the dog health and care monitor - water bowls, movement, loneliness detection, sausage deliveries, projector movie time, wake calls. Boomy-robot patrol integration ready.

sandraschi/benny-the-dog-mcpcommunitylistedunreviewed
Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

  • uv (`curl -LsSf https://astral.sh/uv/install.sh | sh`)
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "benny-the-dog-mcp": {
      "command": "uvx",
      "args": [
        "benny_the_dog_mcp"
      ]
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 26, 2026

benny-the-dog-mcp

Python FastMCP Ruff uv

Benny the dog health and care monitor - water bowls, movement, loneliness detection, sausage deliveries, projector movie time, wake calls. Boomy-robot patrol integration ready.

Fleet-standard fullstack app: FastMCP 3.4 backend, React + Vite + Tailwind frontend, Bun, optional Tauri 2.0 desktop wrapper.

Quick start

uv sync
bun --prefix webapp install
.\start.ps1          # clears ports, starts backend + frontend, opens browser

What it does

  • Care events: log water refills, barks, movement, sausage deliveries, projector movie time, and wake calls via the dog_ops MCP tool.
  • Loneliness detection: the 5-minute patrol job (APScheduler) flags barks with no subsequent movement and suggests a sausage delivery.
  • Dog profile: 6-step onboarding wizard (bio, photos, vet & health, behaviour, walking, dogparks/fountains).
  • Webapp: Dashboard, Tools, Skills, Chat (local LLM), Vet & Health, Settings, Help, Logs, ApiDocs, Jobs, Dog Partners, Shop, Cart, Onboarding.
  • Robot-ready: actor="boomy" on every event for the Boomy robot patrol.

Tools

ToolDescription
dog_opsCare portmanteau: status, water_refill, bark_event, movement, sausage_delivery, movie_time, wake
app_infoServer metadata (name, version, tool count)
server_shutdownGraceful shutdown (confirm=True required)

Full reference: docs/TOOLS.md | llms-full.txt

Claude Desktop config

{
  "mcpServers": {
    "benny": {
      "command": "uv",
      "args": ["run", "--directory", "D:/Dev/repos/benny-the-dog-mcp", "python", "-m", "benny_the_dog_mcp.server"]
    }
  }
}

Environment

Copy .env.example to .env. See docs/CONFIGURATION.md for the full table.

VariableDefaultPurpose
WEB_PORT11142Backend port
OLLAMA_URLhttp://127.0.0.1:11434Chat LLM endpoint
ENABLE_SCHEDULER1Patrol job (5 min)

Ports

Registered in the fleet reservoir: backend 11142, frontend 11143 (see mcp-central-docs/operations/WEBAPP_PORTS.md).

Tests

uv run pytest tests/        # backend (73% coverage)
bun --prefix webapp run e2e # Playwright

Documentation

↑↓ navigate openesc close