Jaraco Website MCP-Server

Der Jaraco Website MCP-Server bietet programmatischen Zugriff auf alle Website-Inhalte, einschließlich Blog-Beiträge, Dienstleistungen und Kategorien. Er ermöglicht KI-Agenten und anderen Clients, Inhalte zu lesen und E-Mails für verschiedene Dienstleistungen zu verfassen.

Übersicht

Der MCP-Server (Model Context Protocol) stellt die Inhalte der Jaraco-Website als strukturierte Ressourcen bereit, auf die von KI-Agenten, Chatbots oder anderen Anwendungen zugegriffen werden kann. Der Server bietet nur Lesezugriff auf alle Inhalte und enthält ein Tool zum Verfassen service-spezifischer E-Mails.

Registrierungsinformationen:

• Registrierungsname: io.github.jrse/jaraco_website
• Veröffentlichte Version: 1.0.1
• PyPI-Paket: jaraco-website-mcp-server
• Registrierungs-URL: https://registry.modelcontextprotocol.io

Funktionen

• Blog-Beiträge lesen: Zugriff auf alle Blog-Beiträge in mehreren Sprachen
• Dienstleistungen lesen: Zugriff auf alle Dienstleistungsbeschreibungen
• Kategorien durchsuchen: Inhalte nach Kategorien organisiert durchsuchen
• Jarakube lesen: Zugriff auf Jaracos Kubernetes-Plattform-Informationen
• E-Mails verfassen: Service-spezifische oder Jarakube E-Mail-Vorlagen mit passendem Standardtext generieren

Verfügbare Ressourcen

Der MCP-Server stellt Ressourcen mit den folgenden URI-Mustern bereit:

Ressourcentypen

Unterstützte Sprachen

Alle Inhalte sind in den folgenden Sprachen verfügbar:

• Englisch (en)
• Deutsch (de)
• Französisch (fr)
• Spanisch (es)
• Niederländisch (nl)

Hinweis: Für lokalisierte Inhalte verwenden Sie das Muster {slug}/{sprache}. Für englische Inhalte können Sie entweder {slug} oder {slug}/en verwenden.

Verbindung zum MCP-Server

Voraussetzungen

1. Python 3.10 oder höher (erforderlich für MCP SDK v2)
2. MCP-Client-Bibliothek für Ihre Programmiersprache

Verbindungsinformationen

• Server-Adresse: https://jarakube.eu/mcp
• Server-Name: jaraco-website
• Version: 1.0.1
• MCP SDK: v2.2.0+
• Registrierungsname: io.github.jrse/jaraco_website

Beispielverbindung (Python)

from mcp.client import Client

async def connect_to_mcp():
    # Verbindung zum MCP-Server mit Streamable HTTP Transport
    client = Client("jaraco-website", url="https://jarakube.eu/mcp")
    await client.connect()

    # Alle Ressourcen auflisten
    resources = await client.list_resources()

    # Einen bestimmten Blog-Beitrag lesen (Englisch)
    post = await client.read_resource("resource://jaraco/blog_posts/from-data-chaos-to-efficient-automation")

    # Einen lokalisierten Blog-Beitrag lesen
    post_de = await client.read_resource("resource://jaraco/blog_posts/from-data-chaos-to-efficient-automation/de")

    # Eine E-Mail für eine Dienstleistung verfassen
    email = await client.call_tool(
        "draft_email",
        {
            "service_slug": "software-development",
            "language": "de",
            "sender_name": "Max Mustermann",
            "sender_email": "max@example.com",
            "custom_text": "Ich benötige Hilfe bei einer benutzerdefinierten Webanwendung."
        }
    )

    await client.disconnect()

**Hinweis**: Das MCP SDK v2 Client handhabt automatisch den Streamable HTTP Transport. Der Endpunkt ist standardmäßig `/mcp`.

## Verwendung des MCP-Servers

### Ressourcen auflisten

Der Server bietet ein `list_website_resources`-Tool zum Auflisten verfügbarer Ressourcen:

# Alle verfügbaren Ressourcen auflisten
resources = await client.call_tool("list_website_resources")

# Ressourcen eines bestimmten Typs auflisten
blog_posts = await client.call_tool(
    "list_website_resources",
    {"resource_type": "blog_posts"}
)

services = await client.call_tool(
    "list_website_resources",
    {"resource_type": "services"}
)

categories = await client.call_tool(
    "list_website_resources",
    {"resource_type": "categories"}
)

jarakube = await client.call_tool(
    "list_website_resources",
    {"resource_type": "jarakube"}
)

**Hinweis:** Das `list_website_resources`-Tool gibt Ressourcen mit vollständigen MCP-URIs wie `resource://jaraco/blog_posts/slug` zurück.

### Ressourcen lesen

Um eine bestimmte Ressource zu lesen, verwenden Sie die vollständige Ressource-URI:

# Einen Blog-Beitrag lesen (Englisch)
post = await client.read_resource("resource://jaraco/blog_posts/vom-datenchaos-zur-effizienten-automatisierung")

# Einen Blog-Beitrag auf Deutsch lesen
post_de = await client.read_resource("resource://jaraco/blog_posts/vom-datenchaos-zur-effizienten-automatisierung/de")

# Eine Dienstleistung lesen (Englisch)
service = await client.read_resource("resource://jaraco/services/software-development")

# Eine Dienstleistung auf Französisch lesen
service_fr = await client.read_resource("resource://jaraco/services/software-development/fr")

# Eine Kategorie lesen
category = await client.read_resource("resource://jaraco/categories/platform-engineering")

# Jarakube-Plattform lesen (Englisch)
jarakube = await client.read_resource("resource://jaraco/jarakube/platform")

# Jarakube-Plattform auf Spanisch lesen
jarakube_es = await client.read_resource("resource://jaraco/jarakube/platform/es")

### E-Mails verfassen

Das `draft_email`-Tool generiert service-spezifische oder Jarakube E-Mail-Vorlagen. Es unterstützt die folgenden Parameter:

| Parameter | Typ | Erforderlich | Standard | Beschreibung |
|-----------|-----|-------------|----------|--------------|
| `service_slug` | string | Ja | - | Die Dienstleistungs-ID (z.B. "software-development") oder "jarakube" für die Jarakube-Plattform |
| `language` | string | Nein | "en" | Sprache für die E-Mail-Vorlage |
| `recipient` | string | Nein | "info@jaraco.de" | E-Mail-Adresse des Empfängers |
| `subject` | string | Nein | Auto-generiert | Benutzerdefinierter E-Mail-Betreff |
| `custom_text` | string | Nein | "" | Zusätzlicher Text für die E-Mail |
| `sender_name` | string | Nein | "" | Name des Absenders |
| `sender_email` | string | Nein | "" | E-Mail-Adresse des Absenders |
| `sender_phone` | string | Nein | "" | Telefonnummer des Absenders |

**Beispiel**:

email = await client.call_tool(
    "draft_email",
    {
        "service_slug": "software-development",
        "language": "de",
        "recipient": "info@jaraco.de",
        "sender_name": "Max Mustermann",
        "sender_email": "max@unternehmen.de",
        "sender_phone": "+49123456789",
        "custom_text": "Wir möchten eine benutzerdefinierte Webanwendung für unsere E-Commerce-Plattform entwickeln. Wir benötigen Expertise in React, Node.js und Datenbankdesign."
    }
)

**Antwortformat**:

{
  "subject": "Anfrage: Softwareentwicklungsdienstleistungen",
  "body": "Sehr geehrtes Jaraco-Team,\n\nWir möchten eine benutzerdefinierte Webanwendung für unsere E-Commerce-Plattform entwickeln. Wir benötigen Expertise in React, Node.js und Datenbankdesign.\n\n[Weitere Vorlageninhalte...]\n\n---\nJaraco GmbH\nSoftware Engineering · Münster\nTelefon: +49 176 85952637\nE-Mail: info@jaraco.de\nWebsite: https://jarakube.eu",
  "to": ["info@jaraco.de"],
  "cc": [],
  "bcc": [],
  "headers": {
    "From": "Max Mustermann <max@unternehmen.de>",
    "Reply-To": "max@unternehmen.de"
  }
}

## Verfügbare Dienstleistungen

Die folgenden Dienstleistungen sind über den MCP-Server verfügbar:

| Dienstleistungs-ID | Beschreibung |
|---------------------|--------------|
| `software-development` | Individuelle Softwareentwicklungsdienstleistungen |
| `consulting` | IT-Beratungsdienstleistungen |
| `it-architecture` | IT-Architektur-Design und -Review |
| `linux-consulting` | Linux-Systemberatung |
| `code-review` | Code-Review und Qualitätsbewertung |
| `technology-assessment` | Bewertung des Technologie-Stacks |

## Verfügbare Kategorien

Inhalte sind in den folgenden Kategorien organisiert:

| Kategorie-ID | Beschreibung |
|--------------|--------------|
| `platform-engineering` | Cloud-, Kubernetes-, Delivery- und Reliability-Arbeit für Softwareunternehmen |
| `platform-assessment` | Fokussierte Bewertung von Architektur, Organisation, Rahmenbedingungen und Engpässen |
| `practical-poc` | Erste praktische Lösungen für Automatisierung, KI-Anwendungsfälle und Software-Engpässe |
| `jarakube` | Die souveräne Kubernetes-Plattform von jaraco |
| `company-founder` | jaracos Engineering-Wurzeln, Gründerprofil und Unternehmensrichtung |


## API-Referenz

### list_resources

Listet alle verfügbaren Ressourcen auf oder filtert nach Typ.

**Parameter:**
- `resource_type` (optional): Filter nach Ressourcentyp. Unterstützte Werte: `services`, `blog_posts`, `categories`, `jarakube`

**Anfrage**:

{
  "name": "list_website_resources",
  "arguments": {
    "resource_type": "services"  // Optional: nach Ressourcentyp filtern
  }
}

**Antwort**:

{
  "resources": [
    {
      "uri": "blog_posts/vom-datenchaos-zur-effizienten-automatisierung",
      "name": "Vom Datenchaos zur effizienten Automatisierung",
      "description": "Wie man...",
      "mimeType": "text/markdown",
      "size": 12345
    },
    {
      "uri": "services/software-development",
      "name": "Softwareentwicklung",
      "description": "Individuelle Softwareentwicklung...",
      "mimeType": "text/markdown",
      "size": 6789
    }
  ]
}

### read_resource

Liest eine bestimmte Ressource über URI.

**Anfrage**:

{
  "uri": "blog_posts/vom-datenchaos-zur-effizienten-automatisierung"
}

**Antwort**:

{
  "contents": [
    {
      "type": "text",
      "text": "# Vom Datenchaos zur effizienten Automatisierung\n\n...",
      "mimeType": "text/markdown"
    }
  ],
  "resourceTemplate": null
}

### call_tool (draft_email)

Verfasst eine E-Mail für eine Dienstleistung.

**Anfrage**:

{
  "name": "draft_email",
  "arguments": {
    "service_slug": "software-development",
    "language": "de",
    "sender_name": "Max Mustermann",
    "sender_email": "max@example.com",
    "custom_text": "Ich benötige Hilfe bei..."
  }
}

**Antwort**:

{
  "content": [
    {
      "type": "text",
      "text": "{\"subject\": \"Anfrage: Softwareentwicklungsdienstleistungen\", ...}",
      "mimeType": "application/json"
    }
  ],
  "isError": false
}

## Sicherheit

- Der MCP-Server bietet **nur Lesezugriff** auf Inhalte
- Standardmäßig ist keine Authentifizierung erforderlich
- Alle Eingaben werden vor der Verarbeitung validiert
- Rate-Limiting ist konfiguriert, um Missbrauch zu verhindern

## MCP-Registrierung

Dieser Server ist in der offiziellen MCP-Registrierung veröffentlicht:

- **Registrierungsname:** `io.github.jrse/jaraco_website`
- **Registrierungs-URL:** https://registry.modelcontextprotocol.io
- **Suche:** https://registry.modelcontextprotocol.io/v0.1/servers?search=jaraco

## Support

Bei Fragen oder Problemen mit dem MCP-Server:

- **E-Mail**: info@jaraco.de
- **Website**: https://jarakube.eu
- **GitHub**: https://github.com/jaracogmbh/jarakube-jaraco-app

## Versionsverlauf

- **1.0.1**: Dokumentation aktualisiert, in MCP-Registrierung veröffentlicht
- **1.0.0**: Erste Version mit Blog-Beiträgen, Dienstleistungen, Kategorien und E-Mail-Erstellung