Serveur MCP

Jaraco GmbH

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.

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.

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
  • Rédiger des e-mails : Générer des modèles d'e-mails spécifiques aux services avec des textes par défaut appropriés

Ressources disponibles

Types de ressources

Type Modèle d'URI Description
Articles de blog blog_posts/{slug}[.{langue}] Articles de blog individuels
Services services/{slug}[.{langue}] Descriptions de services
Catégories categories/{slug} Catégories de contenu

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)

Si aucune langue n'est spécifiée, l'anglais est utilisé par défaut.

Connexion au serveur MCP

Prérequis

  1. Python 3.8 ou version supérieure
  2. 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.0
  • SDK MCP : v2.2.0+

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
    post = await client.read_resource("blog_posts/from-data-chaos-to-efficient-automation")

    # 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

Pour lister toutes les ressources disponibles :



resources = await client.list_resources()



Pour lister les ressources d'un type spécifique :



# Lister uniquement les articles de blog
blog_posts = await client.list_resources("blog_posts/")

# Lister uniquement les services
services = await client.list_resources("services/")

# Lister uniquement les catégories
categories = await client.list_resources("categories/")



### Lire les ressources

Pour lire une ressource spécifique :



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

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

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

# Lire une catégorie
category = await client.read_resource("categories/software-engineering")



### Rédiger des e-mails

L'outil `draft_email` génère des modèles d'e-mails spécifiques aux services. 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") |
| `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 |
|---------------------------|-------------|
| `software-engineering` | Développement et ingénierie logicielle |
| `consulting` | Services de conseil |
| `linux` | Services Linux et d'infrastructure |
| `automation` | Amélioration de l'automatisation et des flux de travail |


## Référence API

### list_resources

Lister toutes les ressources disponibles ou filtrer par type.

**Requête** :


{
  "uri": "blog_posts/"
}



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

## Support

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

- **Email** : info@jaraco.de
- **Site web** : https://jaraco-gmbh.de
- **GitHub** : https://github.com/jaracogmbh/jaraco-website

## Historique des versions

- **1.0.0** : Version initiale avec articles de blog, services, catégories et rédaction d'e-mails