mcp-paprika: Skill for Claude Code

Capture Paprika Wire Format

Overview

End-to-end pipeline for capturing Paprika Cloud Sync API wire format via mitmproxy interception of the macOS desktop client. Produces sanitized HAR 1.2 files with named entries and strongly-typed TypeScript fixture modules for tests.

When to Use

• Reverse-engineering an undocumented Paprika API surface (e.g., bookmarks, pantry locations, custom meal types)
• Verifying wire format assumptions before implementing a new entity type
• Updating existing captures after Paprika app updates change the wire format
• A GitHub issue's DoD includes "capture wire format" or "decoded bodies pasted as comments"

Prerequisites Check

Run these checks before starting. Offer to install anything missing.

# 1. mitmproxy
if command -v mitmdump &>/dev/null; then
  echo "✓ mitmdump $(mitmdump --version 2>&1 | head -1)"
else
  echo "✗ mitmdump not found — install with: brew install mitmproxy"
  # Offer: "Should I run brew install mitmproxy?"
fi

# 2. mitmproxy CA cert
if [ -f ~/.mitmproxy/mitmproxy-ca-cert.pem ]; then
  echo "✓ mitmproxy CA cert exists"
  # Verify it's trusted (security find-certificate returns 0 if found)
  security find-certificate -c "mitmproxy" /Library/Keychains/System.keychain &>/dev/null \
    && echo "✓ CA cert is trusted" \
    || echo "✗ CA cert not trusted — run: sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain ~/.mitmproxy/mitmproxy-ca-cert.pem"
else
  echo "✗ CA cert missing — run mitmdump once to generate it, then trust it"
fi

# 3. Paprika app
if [ -d "/Applications/Paprika Recipe Manager 3.app" ]; then
  echo "✓ Paprika Recipe Manager 3 installed"
else
  echo "✗ Paprika Recipe Manager 3 not found in /Applications"
fi

# 4. Network service (find the active one — not always "Wi-Fi")
NETWORK_SERVICE=$(networksetup -listallnetworkservices | grep -v '^\*' | while read svc; do
  networksetup -getinfo "$svc" 2>/dev/null | grep -q "IP address: [0-9]" && echo "$svc" && break
done)
echo "Active network service: ${NETWORK_SERVICE:-UNKNOWN}"

# 5. Paprika credentials
ENV_FILE="$(python3 -c "
import os, json
# Check XDG config, then macOS default
for base in [os.environ.get('XDG_CONFIG_HOME', ''), os.path.expanduser('~/Library/Preferences')]:
  p = os.path.join(base, 'mcp-paprika', '.env')
  if os.path.isfile(p):
    print(p)
    break
" 2>/dev/null)"
if [ -n "$ENV_FILE" ]; then
  echo "✓ Credentials at: $ENV_FILE"
  grep -qc 'PAPRIKA_EMAIL' "$ENV_FILE" && echo "  ✓ PAPRIKA_EMAIL present" || echo "  ✗ PAPRIKA_EMAIL missing"
  grep -qc 'PAPRIKA_PASSWORD' "$ENV_FILE" && echo "  ✓ PAPRIKA_PASSWORD present" || echo "  ✗ PAPRIKA_PASSWORD missing"
else
  echo "✗ No .env found — check XDG_CONFIG_HOME/mcp-paprika/.env or $ENV_FILE"
fi

# 6. computer-use MCP (can't check programmatically — just note it)
echo "? computer-use MCP: verify it's available (call mcp__computer-use__list_granted_applications)"