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.

Registratie-informatie:

Registratienaam: io.github.jrse/jaraco_website
Gepubliceerde versie: 1.0.1
PyPI-pakket: jaraco-website-mcp-server
Registratie-URL: https://registry.modelcontextprotocol.io

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
Jarakube lezen: Toegang tot Jaraco's Kubernetes-platforminformatie
E-mails opstellen: Genereer service-specifieke of Jarakube e-mail sjablonen met passende standaardtekst

Beschikbare bronnen

De server biedt bronnen aan met de volgende URI-patronen:

Soorten bronnen

Type	URI-patroon	Beschrijving
Blogposts (Engels)	`resource://jaraco/blog_posts/{slug}`	Individuele blogposts in het Engels
Blogposts (Gelokaliseerd)	`resource://jaraco/blog_posts/{slug}/{taal}`	Blogposts in specifieke taal
Diensten (Engels)	`resource://jaraco/services/{slug}`	Dienstenbeschrijvingen in het Engels
Diensten (Gelokaliseerd)	`resource://jaraco/services/{slug}/{taal}`	Dienstenbeschrijvingen in specifieke taal
Categorieën	`resource://jaraco/categories/{slug}`	Inhoudscategorieën
Jarakube-platform (Engels)	`resource://jaraco/jarakube/platform`	Jaraco's Kubernetes-platforminformatie
Jarakube-platform (Gelokaliseerd)	`resource://jaraco/jarakube/platform/{taal}`	Jarakube-platforminformatie in specifieke taal

Ondersteunde talen

Alle inhoud is beschikbaar in de volgende talen:

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

Opmerking: Voor gelokaliseerde inhoud, gebruik het patroon {slug}/{taal}. Voor Engelse inhoud kunt u {slug} of {slug}/en gebruiken.

Verbinding maken met de MCP-server

Vereisten

Python 3.10 of hoger (vereist voor MCP SDK v2)
MCP-clientbibliotheek voor uw programmeertaal

Verbindingsinformatie

Serveradres: https://jarakube.eu/mcp
Servenaam: jaraco-website
Versie: 1.0.1
MCP SDK: v2.2.0+
Registratienaam: io.github.jrse/jaraco_website

Voorbeeldverbinding (Python)


from mcp.client import Client

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

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

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

    # Een gelokaliseerde blogpost lezen
    post_nl = await client.read_resource("resource://jaraco/blog_posts/van-data-chaos-naar-efficiënte-automatisering/nl")

    # 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

De server biedt een `list_website_resources`-tool om beschikbare bronnen weer te geven:


# Alle beschikbare bronnen weergeven
resources = await client.call_tool("list_website_resources")

# Bronnen van een specifiek type weergeven
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"}
)



**Opmerking:** De `list_website_resources`-tool retourneert bronnen met volledige MCP-URI's zoals `resource://jaraco/blog_posts/slug`.

### Bronnen lezen

Om een specifieke bron te lezen, gebruik de volledige bron-URI:


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

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

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

# Een dienst in het Duits lezen
service_de = await client.read_resource("resource://jaraco/services/software-development/de")

# Een categorie lezen
category = await client.read_resource("resource://jaraco/categories/platform-engineering")

# Jarakube-platform lezen (Engels)
jarakube = await client.read_resource("resource://jaraco/jarakube/platform")

# Jarakube-platform in het Frans lezen
jarakube_fr = await client.read_resource("resource://jaraco/jarakube/platform/fr")



### E-mails opstellen

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

| Parameter | Type | Verplicht | Standaard | Beschrijving |
|-----------|------|-----------|-----------|--------------|
| `service_slug` | string | Ja | - | De dienst-identifier (bijv. "software-development") of "jarakube" voor het Jarakube-platform |
| `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 |
|--------------|--------------|
| `platform-engineering` | Cloud-, Kubernetes-, delivery- en reliability-werk voor softwarebedrijven |
| `platform-assessment` | Gerichte beoordeling van architectuur, organisatie, randvoorwaarden en knelpunten |
| `practical-poc` | Eerste praktische oplossingen voor automatisering, AI-toepassingen en softwareknelpunten |
| `jarakube` | Het soevereine Kubernetes-platform van jaraco |
| `company-founder` | jaraco's engineeringbasis, oprichtersprofiel en bedrijfsrichting |


## API-referentie

### list_resources

Alle beschikbare bronnen weergeven of filteren op type.

**Parameters:**
- `resource_type` (optioneel): Filter op brontype. Ondersteunde waarden: `services`, `blog_posts`, `categories`, `jarakube`

**Verzoek**:


{
  "name": "list_website_resources",
  "arguments": {
    "resource_type": "services"
  }
}



**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

## MCP-registratie

Deze server is gepubliceerd in de officiële MCP-registratie:

- **Registratienaam:** `io.github.jrse/jaraco_website`
- **Registratie-URL:** https://registry.modelcontextprotocol.io
- **Zoeken:** https://registry.modelcontextprotocol.io/v0.1/servers?search=jaraco

## Ondersteuning

Voor vragen of problemen met de MCP-server:

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

## Versiegeschiedenis

- **1.0.1**: Documentatie bijgewerkt, gepubliceerd in MCP-registratie
- **1.0.0**: Eerste versie met blogposts, diensten, categorieën en e-mailopstelling