Jaraco Website MCP-server

De Jaraco Website MCP-server (Model Context Protocol) biedt programmeertoegang tot alle website-inhoud, inclusief blogposts, diensten en categorieën. Het stelt AI-agenten en andere clients in staat om inhoud te lezen en e-mails voor verschillende diensten op te stellen.

Overzicht

De MCP-server (Model Context Protocol) stelt de inhoud van de Jaraco-website beschikbaar als gestructureerde bronnen die toegankelijk zijn voor AI-agenten, chatbots of andere toepassingen. De server biedt alleen-lezen toegang tot alle inhoud en bevat een tool voor het opstellen van service-specifieke e-mails.

Functies

Blogposts lezen: Toegang tot alle blogposts in meerdere talen
Diensten lezen: Toegang tot alle diensnbeschrijvingen
Categorieën doorzoeken: Verken inhoud georganiseerd in categorieën
E-mails opstellen: Genereer service-specifieke e-mail sjablonen met passende standaardtekst

Beschikbare bronnen

Soorten bronnen

Type	URI-patroon	Beschrijving
Blogposts	`blog_posts/{slug}[.{taal}]`	Individuele blogposts
Diensten	`services/{slug}[.{taal}]`	Dienstenbeschrijvingen
Categorieën	`categories/{slug}`	Inhoudscategorieën

Ondersteunde talen

Alle inhoud is beschikbaar in de volgende talen:

Engels (en)
Duits (de)
Frans (fr)
Spaans (es)
Nederlands (nl)

Als geen taal is opgegeven, wordt standaard Engels gebruikt.

Verbinding maken met de MCP-server

Vereisten

Python 3.8 of hoger
MCP-clientbibliotheek voor uw programmeertaal

Verbindingsinformatie

Serveradres: https://jarakube.eu/mcp
Servenaam: jaraco-website
Versie: 1.0.0
MCP SDK: v2.2.0+

Voorbeeldverbinding (Python)


from mcp.client import Client

async def connect_to_mcp():
    client = Client("jaraco-website", url="https://jarakube.eu")
    await client.connect()

    # Alle bronnen weergeven
    resources = await client.list_resources()

    # Een specifieke blogpost lezen
    post = await client.read_resource("blog_posts/van-data-chaos-naar-efficiënte-automatisering")

    # Een e-mail voor een dienst opstellen
    email = await client.call_tool(
        "draft_email",
        {
            "service_slug": "software-development",
            "language": "nl",
            "sender_name": "Jan Janssen",
            "sender_email": "jan@example.com",
            "custom_text": "Ik heb hulp nodig bij een maatwerk webapplicatie."
        }
    )

    await client.disconnect()



## Gebruik van de MCP-server

### Bronnen weergeven

Om alle beschikbare bronnen weer te geven:


resources = await client.list_resources()



Om bronnen van een specifiek type weer te geven:


# Alleen blogposts weergeven
blog_posts = await client.list_resources("blog_posts/")

# Alleen diensten weergeven
services = await client.list_resources("services/")

# Alleen categorieën weergeven
categories = await client.list_resources("categories/")



### Bronnen lezen

Om een specifieke bron te lezen:


# Een blogpost lezen
post = await client.read_resource("blog_posts/van-data-chaos-naar-efficiënte-automatisering")

# Een blogpost in het Nederlands lezen
post_nl = await client.read_resource("blog_posts/van-data-chaos-naar-efficiënte-automatisering.nl")

# Een dienst lezen
service = await client.read_resource("services/software-development")

# Een categorie lezen
category = await client.read_resource("categories/software-engineering")



### E-mails opstellen

De `draft_email`-tool genereert service-specifieke e-mail sjablonen. Het ondersteunt de volgende parameters:

| Parameter | Type | Verplicht | Standaard | Beschrijving |
|-----------|------|-----------|-----------|--------------|
| `service_slug` | string | Ja | - | De dienst-identifier (bijv. "software-development") |
| `language` | string | Nee | "en" | Taal voor de e-mail sjabloon |
| `recipient` | string | Nee | "info@jaraco.de" | E-mailadres van de ontvanger |
| `subject` | string | Nee | Automatisch gegenereerd | Aangepast e-mailonderwerp |
| `custom_text` | string | Nee | "" | Extra tekst om in de e-mail op te nemen |
| `sender_name` | string | Nee | "" | Naam van de afzender |
| `sender_email` | string | Nee | "" | E-mailadres van de afzender |
| `sender_phone` | string | Nee | "" | Telefoonnummer van de afzender |

**Voorbeeld**:


email = await client.call_tool(
    "draft_email",
    {
        "service_slug": "software-development",
        "language": "nl",
        "recipient": "info@jaraco.de",
        "sender_name": "Jan Janssen",
        "sender_email": "jan@bedrijf.nl",
        "sender_phone": "+31123456789",
        "custom_text": "We willen een maatwerk webapplicatie ontwikkelen voor ons e-commerce platform. We hebben expertise nodig in React, Node.js en databasedesign."
    }
)



**Antwoordformaat**:


{
  "subject": "Aanvraag: Softwareontwikkelingsdiensten",
  "body": "Geachte Jaraco-team,\n\nWe willen een maatwerk webapplicatie ontwikkelen voor ons e-commerce platform. We hebben expertise nodig in React, Node.js en databasedesign.\n\n[Extra sjablooninhoud...]\n\n---\nJaraco GmbH\nSoftware engineering · Münster\nTelefoon: +49 176 85952637\nE-mail: info@jaraco.de\nWebsite: https://jaraco-gmbh.de",
  "to": ["info@jaraco.de"],
  "cc": [],
  "bcc": [],
  "headers": {
    "From": "Jan Janssen <jan@bedrijf.nl>",
    "Reply-To": "jan@bedrijf.nl"
  }
}



## Beschikbare diensten

De volgende diensten zijn beschikbaar via de MCP-server:

| Dienst-ID | Beschrijving |
|-----------|--------------|
| `software-development` | Maatwerk softwareontwikkelingsdiensten |
| `consulting` | IT-adviesdiensten |
| `it-architecture` | IT-architectuur ontwerp en review |
| `linux-consulting` | Linux-systeemadvies |
| `code-review` | Code review en kwaliteitsbeoordeling |
| `technology-assessment` | Technologie-stack evaluatie |

## Beschikbare categorieën

Inhoud is georganiseerd in de volgende categorieën:

| Categorie-ID | Beschrijving |
|--------------|--------------|
| `software-engineering` | Softwareontwikkeling en -engineering |
| `consulting` | Adviesdiensten |
| `linux` | Linux- en infrastructuurdiensten |
| `automation` | Automatisering en workflowverbetering |


## API-referentie

### list_resources

Alle beschikbare bronnen weergeven of filteren op type.

**Verzoek**:


{
  "uri": "blog_posts/"
}



**Antwoord**:


{
  "resources": [
    {
      "uri": "blog_posts/van-data-chaos-naar-efficiënte-automatisering",
      "name": "Van data chaos naar efficiënte automatisering",
      "description": "Hoe te transformeren...",
      "mimeType": "text/markdown",
      "size": 12345
    }
  ]
}



### read_resource

Een specifieke bron lezen via URI.

**Verzoek**:


{
  "uri": "blog_posts/van-data-chaos-naar-efficiënte-automatisering"
}



**Antwoord**:


{
  "contents": [
    {
      "type": "text",
      "text": "# Van data chaos naar efficiënte automatisering\n\n...",
      "mimeType": "text/markdown"
    }
  ]
}



### call_tool (draft_email)

Een e-mail voor een dienst opstellen.

**Verzoek**:


{
  "name": "draft_email",
  "arguments": {
    "service_slug": "software-development",
    "language": "nl",
    "sender_name": "Jan Janssen",
    "sender_email": "jan@example.com",
    "custom_text": "Ik heb hulp nodig bij..."
  }
}



**Antwoord**:


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



## Beveiliging

- De MCP-server biedt **alleen-lezen toegang** tot inhoud
- Standaard is geen authenticatie vereist (kan worden toegevoegd als dat nodig is)
- Alle invoer wordt geverifieerd voordat deze wordt verwerkt
- Rate limiting is geconfigureerd om misbruik te voorkomen

## Ondersteuning

Voor vragen of problemen met de MCP-server:

- **E-mail**: info@jaraco.de
- **Website**: https://jaraco-gmbh.de
- **GitHub**: https://github.com/jaracogmbh/jaraco-website

## Versiegeschiedenis

- **1.0.0**: Eerste versie met blogposts, diensten, categorieën en e-mailopstelling