Serveur MCP du site Jaraco

Le serveur MCP (Model Context Protocol) du site Jaraco fournit un accès programmatique à tout le contenu du site, y compris les articles de blog, les services et les catégories. Il permet aux agents IA et autres clients de lire le contenu et de rédiger des e-mails pour différents services.

Aperçu

Le serveur MCP (Model Context Protocol) expose le contenu du site web Jaraco sous forme de ressources structurées accessibles par des agents IA, des chatbots ou d'autres applications. Le serveur fournit un accès en lecture seule à tout le contenu et inclut un outil pour rédiger des e-mails spécifiques aux services.

Informations de registre :

Nom de registre : io.github.jrse/jaraco_website
Version publiée : 1.0.1
Package PyPI : jaraco-website-mcp-server
URL de registre : https://registry.modelcontextprotocol.io

Fonctionnalités

Lire les articles de blog : Accéder à tous les articles de blog dans plusieurs langues
Lire les services : Accéder à toutes les descriptions de services
Parcourir les catégories : Explorer le contenu organisé par catégories
Lire Jarakube : Accéder aux informations sur la plateforme Kubernetes de Jaraco
Rédiger des e-mails : Générer des modèles d'e-mails spécifiques aux services ou Jarakube avec des textes par défaut appropriés

Ressources disponibles

Le serveur expose des ressources avec les modèles d'URI suivants :

Types de ressources

Type	Modèle d'URI	Description
Articles de blog (Anglais)	`resource://jaraco/blog_posts/{slug}`	Articles de blog individuels en anglais
Articles de blog (Localisés)	`resource://jaraco/blog_posts/{slug}/{langue}`	Articles de blog dans une langue spécifique
Services (Anglais)	`resource://jaraco/services/{slug}`	Descriptions de services en anglais
Services (Localisés)	`resource://jaraco/services/{slug}/{langue}`	Descriptions de services dans une langue spécifique
Catégories	`resource://jaraco/categories/{slug}`	Catégories de contenu
Plateforme Jarakube (Anglais)	`resource://jaraco/jarakube/platform`	Informations sur la plateforme Kubernetes de Jaraco
Plateforme Jarakube (Localisée)	`resource://jaraco/jarakube/platform/{langue}`	Informations sur Jarakube dans une langue spécifique

Langues prises en charge

Tout le contenu est disponible dans les langues suivantes :

Anglais (en)
Allemand (de)
Français (fr)
Espagnol (es)
Néerlandais (nl)

Remarque : Pour les contenus localisés, utilisez le modèle {slug}/{langue}. Pour les contenus en anglais, vous pouvez utiliser {slug} ou {slug}/en.

Connexion au serveur MCP

Prérequis

Python 3.10 ou version supérieure (requis pour MCP SDK v2)
Bibliothèque cliente MCP pour votre langage de programmation

Informations de connexion

Adresse du serveur : https://jarakube.eu/mcp
Nom du serveur : jaraco-website
Version : 1.0.1
SDK MCP : v2.2.0+
Nom de registre : io.github.jrse/jaraco_website

Exemple de connexion (Python)


from mcp.client import Client

async def connect_to_mcp():
    # Connexion au serveur MCP avec transport Streamable HTTP
    client = Client("jaraco-website", url="https://jarakube.eu/mcp")
    await client.connect()

    # Lister toutes les ressources
    resources = await client.list_resources()

    # Lire un article de blog spécifique (Anglais)
    post = await client.read_resource("resource://jaraco/blog_posts/from-data-chaos-to-efficient-automation")

    # Lire un article de blog localisé
    post_fr = await client.read_resource("resource://jaraco/blog_posts/from-data-chaos-to-efficient-automation/fr")

    # Rédiger un e-mail pour un service
    email = await client.call_tool(
        "draft_email",
        {
            "service_slug": "software-development",
            "language": "fr",
            "sender_name": "Jean Dupont",
            "sender_email": "jean@example.com",
            "custom_text": "J'ai besoin d'aide pour une application web personnalisée."
        }
    )

    await client.disconnect()



**Note** : Le client SDK MCP v2 gère automatiquement le transport Streamable HTTP. Le point de terminaison est `/mcp` par défaut.

## Utilisation du serveur MCP

### Lister les ressources

Le serveur fournit un outil `list_website_resources` pour lister les ressources disponibles :


# Lister toutes les ressources disponibles
resources = await client.call_tool("list_website_resources")

# Lister les ressources d'un type spécifique
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"}
)



**Remarque :** L'outil `list_website_resources` retourne des ressources avec des URI MCP complètes comme `resource://jaraco/blog_posts/slug`.

### Lire les ressources

Pour lire une ressource spécifique, utilisez l'URI complète de la ressource :


# Lire un article de blog (Anglais)
post = await client.read_resource("resource://jaraco/blog_posts/du-chaos-des-donnees-a-l-automatisation-efficace")

# Lire un article de blog en français
post_fr = await client.read_resource("resource://jaraco/blog_posts/du-chaos-des-donnees-a-l-automatisation-efficace/fr")

# Lire un service (Anglais)
service = await client.read_resource("resource://jaraco/services/software-development")

# Lire un service en espagnol
service_es = await client.read_resource("resource://jaraco/services/software-development/es")

# Lire une catégorie
category = await client.read_resource("resource://jaraco/categories/platform-engineering")

# Lire la plateforme Jarakube (Anglais)
jarakube = await client.read_resource("resource://jaraco/jarakube/platform")

# Lire la plateforme Jarakube en allemand
jarakube_de = await client.read_resource("resource://jaraco/jarakube/platform/de")



### Rédiger des e-mails

L'outil `draft_email` génère des modèles d'e-mails spécifiques aux services ou Jarakube. Il prend en charge les paramètres suivants :

| Paramètre | Type | Obligatoire | Défaut | Description |
|-----------|------|-------------|--------|-------------|
| `service_slug` | string | Oui | - | L'identifiant du service (ex. "software-development") ou "jarakube" pour la plateforme Jarakube |
| `language` | string | Non | "en" | Langue pour le modèle d'e-mail |
| `recipient` | string | Non | "info@jaraco.de" | Adresse e-mail du destinataire |
| `subject` | string | Non | Généré automatiquement | Objet de l'e-mail personnalisé |
| `custom_text` | string | Non | "" | Texte supplémentaire à inclure dans l'e-mail |
| `sender_name` | string | Non | "" | Nom de l'expéditeur |
| `sender_email` | string | Non | "" | Adresse e-mail de l'expéditeur |
| `sender_phone` | string | Non | "" | Numéro de téléphone de l'expéditeur |

**Exemple** :


email = await client.call_tool(
    "draft_email",
    {
        "service_slug": "software-development",
        "language": "fr",
        "recipient": "info@jaraco.de",
        "sender_name": "Jean Dupont",
        "sender_email": "jean@entreprise.com",
        "sender_phone": "+33123456789",
        "custom_text": "Nous souhaitons développer une application web personnalisée pour notre plateforme e-commerce. Nous avons besoin d'expertise en React, Node.js et conception de base de données."
    }
)



**Format de réponse** :


{
  "subject": "Demande : Services de développement logiciel",
  "body": "Cher équipe Jaraco,\n\nNous souhaitons développer une application web personnalisée pour notre plateforme e-commerce. Nous avons besoin d'expertise en React, Node.js et conception de base de données.\n\n[Contenu supplémentaire du modèle...]\n\n---\nJaraco GmbH\nIngénierie logicielle · Münster\nTéléphone : +49 176 85952637\nEmail : info@jaraco.de\nSite web : https://jaraco-gmbh.de",
  "to": ["info@jaraco.de"],
  "cc": [],
  "bcc": [],
  "headers": {
    "From": "Jean Dupont <jean@entreprise.com>",
    "Reply-To": "jean@entreprise.com"
  }
}



## Services disponibles

Les services suivants sont disponibles via le serveur MCP :

| Identifiant du service | Description |
|------------------------|-------------|
| `software-development` | Services de développement logiciel sur mesure |
| `consulting` | Services de conseil en informatique |
| `it-architecture` | Conception et revue d'architecture informatique |
| `linux-consulting` | Conseil en systèmes Linux |
| `code-review` | Revue de code et évaluation de la qualité |
| `technology-assessment` | Évaluation de la stack technologique |

## Catégories disponibles

Le contenu est organisé dans les catégories suivantes :

| Identifiant de la catégorie | Description |
|---------------------------|-------------|
| `platform-engineering` | Cloud, Kubernetes, livraison et fiabilité pour les éditeurs de logiciels |
| `platform-assessment` | Évaluation ciblée de l'architecture, de l'organisation, des contraintes et des blocages |
| `practical-poc` | Premières solutions concrètes pour l'automatisation, les cas d'usage IA et les blocages logiciels |
| `jarakube` | La plateforme Kubernetes souveraine de jaraco |
| `company-founder` | Les racines d'ingénierie de jaraco, le profil du fondateur et l'orientation de l'entreprise |


## Référence API

### list_resources

Lister toutes les ressources disponibles ou filtrer par type.

**Paramètres :**
- `resource_type` (optionnel) : Filtrer par type de ressource. Valeurs prises en charge : `services`, `blog_posts`, `categories`, `jarakube`

**Requête** :


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



**Réponse** :


{
  "resources": [
    {
      "uri": "blog_posts/du-chaos-des-donnees-a-l-automatisation-efficace",
      "name": "Du chaos des données à l'automatisation efficace",
      "description": "Comment transformer...",
      "mimeType": "text/markdown",
      "size": 12345
    }
  ]
}



### read_resource

Lire une ressource spécifique par URI.

**Requête** :


{
  "uri": "blog_posts/du-chaos-des-donnees-a-l-automatisation-efficace"
}



**Réponse** :


{
  "contents": [
    {
      "type": "text",
      "text": "# Du chaos des données à l'automatisation efficace\n\n...",
      "mimeType": "text/markdown"
    }
  ]
}



### call_tool (draft_email)

Rédiger un e-mail pour un service.

**Requête** :


{
  "name": "draft_email",
  "arguments": {
    "service_slug": "software-development",
    "language": "fr",
    "sender_name": "Jean Dupont",
    "sender_email": "jean@example.com",
    "custom_text": "J'ai besoin d'aide pour..."
  }
}



**Réponse** :


{
  "content": [
    {
      "type": "text",
      "text": "{\"subject\": \"Demande : Services de développement logiciel\", ...}",
      "mimeType": "application/json"
    }
  ],
  "isError": false
}



## Sécurité

- Le serveur MCP fournit un **accès en lecture seule** au contenu
- Aucune authentification n'est requise par défaut (peut être ajoutée si nécessaire)
- Toutes les entrées sont validées avant le traitement
- La limitation du débit est configurée pour éviter les abus

## Registre MCP

Ce serveur est publié dans le registre MCP officiel :

- **Nom de registre :** `io.github.jrse/jaraco_website`
- **URL de registre :** https://registry.modelcontextprotocol.io
- **Recherche :** https://registry.modelcontextprotocol.io/v0.1/servers?search=jaraco

## Support

Pour les questions ou problèmes concernant le serveur MCP :

- **Email** : info@jaraco.de
- **Site web** : https://jarakube.eu
- **GitHub** : https://github.com/jaracogmbh/jarakube-jaraco-app

## Historique des versions

- **1.0.1** : Documentation mise à jour, publiée dans le registre MCP
- **1.0.0** : Version initiale avec articles de blog, services, catégories et rédaction d'e-mails