DevHub

DevHub CMS MCP

Eine Model Context Protocol (MCP)-Integration zur Verwaltung von Inhalten im DevHub CMS-System.

Installation

Sie benötigen den uv-Paketmanager, der auf Ihrem lokalen System installiert ist.

Manuelle Konfiguration von Claude Desktop

Um diesen Server mit der Claude Desktop-App zu verwenden, fügen Sie die folgende Konfiguration zum Abschnitt „mcpServers“ Ihrer claude_desktop_config.json hinzu:

{
    "mcpServers": {
        "devhub_cms_mcp": {
            "command": "uvx",
            "args": [
                "devhub-cms-mcp"
            ],
            "env": {
                "DEVHUB_API_KEY": "YOUR_KEY_HERE",
                "DEVHUB_API_SECRET": "YOUR_SECRET_HERE",
                "DEVHUB_BASE_URL": "https://yourbrand.cloudfrontend.net"
            }
        }
    }
}

Starten Sie Claude Desktop nach der Aktualisierung der Konfiguration neu.

Manuelle Konfiguration für Cursor

Dieses MCP kann auch in Cursor verwendet werden, mit einer ähnlichen Konfiguration wie oben, die zu Ihrer Cursor-globalen Umgebung oder zu einzelnen Projekten hinzugefügt wird.

Beispiele hier

Installation über Claude Code

Die Befehlszeile von Claude Code unterstützt MCP-Installationen.

Sie können das devhub-cms-mcp hinzufügen, indem Sie die folgenden Umgebungsvariablen aktualisieren:

claude mcp add devhub-cms-mcp \
    -e DEVHUB_API_KEY=YOUR_KEY_HERE \
    -e DEVHUB_API_SECRET=YOUR_SECRET_HERE \
    -e DEVHUB_BASE_URL=https://yourbrand.cloudfrontend.net \
    -- uvx devhub-cms-mcp

Installation über Smithery

Um DevHub CMS MCP automatisch über Smithery für Claude Desktop zu installieren:

npx -y @smithery/cli install @devhub/devhub-cms-mcp --client claude

Lokale Entwicklung

Repository klonen (oder Ihren Fork)

git clone git@github.com:devhub/devhub-cms-mcp.git

Manuelle Konfiguration von Claude Desktop

Um diesen Server mit der Claude Desktop-App für die lokale Entwicklung zu verwenden, fügen Sie die folgende Konfiguration zum Abschnitt „mcpServers“ Ihrer claude_desktop_config.json hinzu:

{
    "mcpServers": {
        "devhub_cms_mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "/YOUR/LOCAL/PATH/devhub-cms-mcp/",
                "run",
                "main.py"
            ],
            "env": {
                "DEVHUB_API_KEY": "YOUR_KEY_HERE",
                "DEVHUB_API_SECRET": "YOUR_SECRET_HERE",
                "DEVHUB_BASE_URL": "https://yourbrand.cloudfrontend.net"
            }
        }
    }
}

Starten Sie Claude Desktop nach der Aktualisierung der Konfiguration neu.

Konfiguration für die direkte Ausführung mit uv

Dieses MCP erfordert, dass die folgenden Umgebungsvariablen gesetzt sind:

export DEVHUB_API_KEY="your_api_key"
export DEVHUB_API_SECRET="your_api_secret"
export DEVHUB_BASE_URL="https://yourbrand.cloudfrontend.net"

Führen Sie dann das MCP aus:

uv run main.py

Verfügbare Werkzeuge

Dieses MCP bietet die folgenden Werkzeuge für die Interaktion mit DevHub CMS:

Unternehmens- und Standortverwaltung

• get_businesses(): Ruft alle Unternehmen innerhalb des DevHub-Kontos ab. Gibt eine Liste von Unternehmen mit ihren IDs und Namen zurück.
• get_locations(business_id): Ruft alle Standorte für ein bestimmtes Unternehmen ab. Gibt detaillierte Standortinformationen zurück, einschließlich Adresse, Koordinaten und URLs.
• get_hours_of_operation(location_id, hours_type='primary'): Ruft die Öffnungszeiten für einen bestimmten DevHub-Standort ab. Gibt eine strukturierte Liste von Zeitbereichen für jeden Wochentag zurück.
• update_hours(location_id, new_hours, hours_type='primary'): Aktualisiert die Öffnungszeiten für einen DevHub-Standort.
• get_nearest_location(business_id, latitude, longitude): Findet den nächstgelegenen DevHub-Standort basierend auf geografischen Koordinaten.
• site_from_url(url): Ruft die DevHub-Site-ID und Details von einer URL ab. Gibt Site-ID, URL und zugehörige Standort-IDs zurück.

Inhaltsverwaltung

• get_blog_post(post_id): Ruft einen einzelnen Blogbeitrag anhand der ID ab, einschließlich Titel, Datum und HTML-Inhalt.
• create_blog_post(site_id, title, content): Erstellt einen neuen Blogbeitrag. Der Inhalt sollte im HTML-Format vorliegen und kein H1-Tag enthalten.
• update_blog_post(post_id, title=None, content=None): Aktualisiert den Titel und/oder Inhalt eines bestehenden Blogbeitrags.

Medienverwaltung

• upload_image(base64_image_content, filename): Lädt ein Bild in die DevHub-Mediengalerie hoch. Unterstützt die Formate webp, jpeg und png. Das Bild muss als base64-kodierter String bereitgestellt werden.

Verwendung mit LLMs

Dieses MCP ist für die Verwendung mit Large Language Models konzipiert, die das Model Context Protocol unterstützen. Es ermöglicht LLMs, Inhalte in DevHub CMS zu verwalten, ohne dass ein direkter API-Zugriff nativ in das LLM integriert sein muss.

Testen

Dieses Paket enthält eine Testsuite mit simulierten Anfragen an die DevHub-API, sodass Sie die Funktionalität testen können, ohne tatsächliche API-Aufrufe durchzuführen.

Tests ausführen

Um die Tests auszuführen, installieren Sie zunächst das Paket mit den Testabhängigkeiten:

uv pip install -e ".[test]"

Führen Sie die Tests mit pytest aus:

uv run pytest

Für detailliertere Ausgaben und Informationen zur Testabdeckung:

uv run pytest -v --cov=devhub_cms_mcp

Teststruktur

• tests/devhub_cms_mcp/test_mcp_integration.py: Tests für MCP-Integrationsendpunkte