jermainee/casalist-mcp

Casalist MCP Server

Ein Model Context Protocol (MCP) Server, der Claude die Möglichkeit gibt, Möbel und Einrichtungsgegenstände von Casalist.de zu durchsuchen und zu vergleichen - Deutschlands führender Möbel-Vergleichsplattform.

Funktionen

• Möbelsuche: Suche nach spezifischen Möbelstücken mit erweiterten Filteroptionen
• Kategoriebasierte Suche: Durchstöbern von Möbeln nach Zimmerkategorien (Wohnzimmer, Schlafzimmer, Küche, etc.)
• Schnäppchen-Finder: Aktuelle Angebote und reduzierte Möbel finden
• Budget-freundliche Suche: Möbel innerhalb bestimmter Preisbereiche filtern
• Premium-Möbelsuche: Hochwertige Möbel oberhalb bestimmter Preispunkte finden
• Preisbereich-Analyse: Detaillierte Preisstatistiken für Möbelkategorien
• Vergleichstool: Mehrere Möbeloptionen mit detaillierter Analyse vergleichen

Verfügbare Tools

Kern-Suchfunktionen

• search_furniture() - Allgemeine Möbelsuche mit erweiterten Filtern
• search_furniture_by_category() - Suche nach Raum/Kategorie
• get_furniture_deals() - Aktuelle Angebote und Rabatte finden
• search_budget_furniture() - Möbel innerhalb von Budget-Grenzen finden
• search_premium_furniture() - Suche nach hochwertigen Möbeln
• get_product_price_range() - Preisbereiche für Möbeltypen analysieren
• compare_furniture_options() - Mehrere Möbeloptionen vergleichen

Unterstützte Kategorien

• Wohnzimmer: Sofas, Sessel, Couchtische, TV-Möbel
• Schlafzimmer: Betten, Kleiderschränke, Nachttische
• Küche: Küchenmöbel, Esstische, Stühle
• Büro: Bürostühle, Schreibtische, Regale
• Kinderzimmer: Kinderbetten, Spielzeugaufbewahrung

Installation

Voraussetzungen

• Python 3.8+
• Claude Desktop App

Installation

uv sync

Umgebungseinrichtung

Erstelle eine .env-Datei im Projektverzeichnis:

API_URL=https://casalist.de/api

cp .env.example .env

Lokal ausführen

uv run python casalist_mcp.py

Lokaler Debug-Modus

Setze Umgebungsvariable für ausführliche Protokollierung:

export MCP_DEBUG=1
uv run python casalist_mcp.py

Claude Desktop Konfiguration

Füge folgendes zu deiner Claude Desktop Konfigurationsdatei hinzu:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "casalist": {
      "command": "python",
      "args": ["/pfad/zu/casalist_mcp.py"],
      "env": {
        "API_URL": "https://casalist.de/api"
      }
    }
  }
}

Ersetze /pfad/zu/casalist_mcp.py mit dem tatsächlichen Pfad zu deinem Script.

Verwendung einer virtuellen Umgebung

Wenn du eine virtuelle Umgebung verwendest, gib den vollständigen Pfad zum Python-Interpreter an:

{
  "mcpServers": {
    "casalist": {
      "command": "/pfad/zu/deiner/venv/bin/python",
      "args": ["/pfad/zu/casalist_mcp.py"]
    }
  }
}

Verwendungsbeispiele

Nach der Konfiguration kannst du natürliche Sprache mit Claude verwenden, um nach Möbeln zu suchen:

Einfache Suche

"Finde mir ein bequemes Sofa unter 800 Euro"
"Zeige mir Esstische für 4 Personen"
"Ich brauche einen günstigen Bürostuhl"

Erweiterte Filterung

"Finde Premium-Ledersofas über 1500 Euro"
"Zeige mir aktuelle Schlafzimmermöbel-Angebote"
"Vergleiche Couchtische zwischen 200-400 Euro"

Kategoriebasierte Suche

"Zeige mir Wohnzimmermöbel"
"Ich brauche Büromöbel für ein Homeoffice"
"Finde Kinderzimmermöbel"

Schnäppchen finden

"Welche Möbelangebote gibt es heute?"
"Finde reduzierte Esszimmergarnituren"
"Zeige mir die besten Möbelangebote unter 500 Euro"