Servidor MCP del sitio web de Jaraco

El servidor MCP (Model Context Protocol) del sitio web de Jaraco proporciona acceso programático a todo el contenido del sitio, incluyendo publicaciones de blog, servicios y categorías. Permite a los agentes de IA y otros clientes leer el contenido y redactar correos electrónicos para diferentes servicios.

Descripción general

El servidor MCP (Model Context Protocol) expone el contenido del sitio web de Jaraco como recursos estructurados a los que pueden acceder agentes de IA, chatbots u otras aplicaciones. El servidor proporciona acceso de solo lectura a todo el contenido e incluye una herramienta para redactar correos electrónicos específicos de servicios.

Información del registro:

Nombre del registro: io.github.jrse/jaraco_website
Versión publicada: 1.0.1
Paquete PyPI: jaraco-website-mcp-server
URL del registro: https://registry.modelcontextprotocol.io

Características

Leer publicaciones de blog: Acceder a todas las publicaciones de blog en varios idiomas
Leer servicios: Acceder a todas las descripciones de servicios
Explorar categorías: Explorar contenido organizado por categorías
Leer Jarakube: Acceder a la información de la plataforma Kubernetes de Jaraco
Redactar correos electrónicos: Generar plantillas de correo electrónico específicas de servicios o Jarakube con textos predeterminados apropiados

Recursos disponibles

El servidor expone recursos con los siguientes patrones de URI:

Tipos de recursos

Tipo	Patrón de URI	Descripción
Publicaciones de blog (Inglés)	`resource://jaraco/blog_posts/{slug}`	Publicaciones de blog individuales en inglés
Publicaciones de blog (Localizadas)	`resource://jaraco/blog_posts/{slug}/{idioma}`	Publicaciones de blog en idioma específico
Servicios (Inglés)	`resource://jaraco/services/{slug}`	Descripciones de servicios en inglés
Servicios (Localizados)	`resource://jaraco/services/{slug}/{idioma}`	Descripciones de servicios en idioma específico
Categorías	`resource://jaraco/categories/{slug}`	Categorías de contenido
Plataforma Jarakube (Inglés)	`resource://jaraco/jarakube/platform`	Información de la plataforma Kubernetes de Jaraco
Plataforma Jarakube (Localizada)	`resource://jaraco/jarakube/platform/{idioma}`	Información de Jarakube en idioma específico

Idiomas admitidos

Todo el contenido está disponible en los siguientes idiomas:

Inglés (en)
Alemán (de)
Francés (fr)
Español (es)
Neerlandés (nl)

Nota: Para contenidos localizados, use el patrón {slug}/{idioma}. Para contenidos en inglés, puede usar {slug} o {slug}/en.

Conexión al servidor MCP

Requisitos previos

Python 3.10 o superior (requerido para MCP SDK v2)
Biblioteca cliente MCP para su lenguaje de programación

Información de conexión

Dirección del servidor: https://jarakube.eu/mcp
Nombre del servidor: jaraco-website
Versión: 1.0.1
SDK MCP: v2.2.0+
Nombre del registro: io.github.jrse/jaraco_website

Ejemplo de conexión (Python)


from mcp.client import Client

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

    # Listar todos los recursos
    resources = await client.list_resources()

    # Leer una publicación de blog específica (Inglés)
    post = await client.read_resource("resource://jaraco/blog_posts/del-caos-de-datos-a-la-automatizacion-eficiente")

    # Leer una publicación de blog localizada
    post_es = await client.read_resource("resource://jaraco/blog_posts/del-caos-de-datos-a-la-automatizacion-eficiente/es")

    # Redactar un correo electrónico para un servicio
    email = await client.call_tool(
        "draft_email",
        {
            "service_slug": "software-development",
            "language": "es",
            "sender_name": "Juan Pérez",
            "sender_email": "juan@example.com",
            "custom_text": "Necesito ayuda con una aplicación web personalizada."
        }
    )

    await client.disconnect()



## Uso del servidor MCP

### Listar recursos

El servidor proporciona una herramienta `list_website_resources` para listar los recursos disponibles:


# Listar todos los recursos disponibles
resources = await client.call_tool("list_website_resources")

# Listar recursos de un tipo específico
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"}
)



**Nota:** La herramienta `list_website_resources` devuelve recursos con URIs MCP completas como `resource://jaraco/blog_posts/slug`.

### Leer recursos

Para leer un recurso específico, use la URI completa del recurso:


# Leer una publicación de blog (Inglés)
post = await client.read_resource("resource://jaraco/blog_posts/del-caos-de-datos-a-la-automatizacion-eficiente")

# Leer una publicación de blog en español
post_es = await client.read_resource("resource://jaraco/blog_posts/del-caos-de-datos-a-la-automatizacion-eficiente/es")

# Leer un servicio (Inglés)
service = await client.read_resource("resource://jaraco/services/software-development")

# Leer un servicio en neerlandés
service_nl = await client.read_resource("resource://jaraco/services/software-development/nl")

# Leer una categoría
category = await client.read_resource("resource://jaraco/categories/platform-engineering")

# Leer la plataforma Jarakube (Inglés)
jarakube = await client.read_resource("resource://jaraco/jarakube/platform")

# Leer la plataforma Jarakube en francés
jarakube_fr = await client.read_resource("resource://jaraco/jarakube/platform/fr")



### Redactar correos electrónicos

La herramienta `draft_email` genera plantillas de correo electrónico específicas de servicios o Jarakube. Admite los siguientes parámetros:

| Parámetro | Tipo | Obligatorio | Predeterminado | Descripción |
|-----------|------|-------------|---------------|-------------|
| `service_slug` | string | Sí | - | El identificador del servicio (ej. "software-development") o "jarakube" para la plataforma Jarakube |
| `language` | string | No | "en" | Idioma para la plantilla de correo electrónico |
| `recipient` | string | No | "info@jaraco.de" | Dirección de correo electrónico del destinatario |
| `subject` | string | No | Generado automáticamente | Asunto de correo electrónico personalizado |
| `custom_text` | string | No | "" | Texto adicional para incluir en el correo electrónico |
| `sender_name` | string | No | "" | Nombre del remitente |
| `sender_email` | string | No | "" | Dirección de correo electrónico del remitente |
| `sender_phone` | string | No | "" | Número de teléfono del remitente |

**Ejemplo**:


email = await client.call_tool(
    "draft_email",
    {
        "service_slug": "software-development",
        "language": "es",
        "recipient": "info@jaraco.de",
        "sender_name": "Juan Pérez",
        "sender_email": "juan@empresa.com",
        "sender_phone": "+34123456789",
        "custom_text": "Queremos desarrollar una aplicación web personalizada para nuestra plataforma de comercio electrónico. Necesitamos experiencia en React, Node.js y diseño de bases de datos."
    }
)



**Formato de respuesta**:


{
  "subject": "Consulta: Servicios de desarrollo de software",
  "body": "Estimado equipo de Jaraco,\n\nQueremos desarrollar una aplicación web personalizada para nuestra plataforma de comercio electrónico. Necesitamos experiencia en React, Node.js y diseño de bases de datos.\n\n[Contenido adicional de la plantilla...]\n\n---\nJaraco GmbH\nIngeniería de software · Münster\nTeléfono: +49 176 85952637\nCorreo electrónico: info@jaraco.de\nSitio web: https://jaraco-gmbh.de",
  "to": ["info@jaraco.de"],
  "cc": [],
  "bcc": [],
  "headers": {
    "From": "Juan Pérez <juan@empresa.com>",
    "Reply-To": "juan@empresa.com"
  }
}



## Servicios disponibles

Los siguientes servicios están disponibles a través del servidor MCP:

| Identificador del servicio | Descripción |
|-----------------------------|-------------|
| `software-development` | Servicios de desarrollo de software personalizado |
| `consulting` | Servicios de consultoría de TI |
| `it-architecture` | Diseño y revisión de arquitectura de TI |
| `linux-consulting` | Consultoría de sistemas Linux |
| `code-review` | Revisión de código y evaluación de calidad |
| `technology-assessment` | Evaluación de la pila tecnológica |

## Categorías disponibles

El contenido está organizado en las siguientes categorías:

| Identificador de la categoría | Descripción |
|-------------------------------|-------------|
| `platform-engineering` | Trabajo de cloud, Kubernetes, entrega y fiabilidad para empresas de software |
| `platform-assessment` | Evaluación enfocada de arquitectura, organización, restricciones y cuellos de botella |
| `practical-poc` | Primeras soluciones prácticas para automatización, casos de IA y cuellos de botella de software |
| `jarakube` | La plataforma Kubernetes soberana de jaraco |
| `company-founder` | Las raíces de ingeniería de jaraco, el perfil del fundador y la orientación de la empresa |

## Referencia de la API

### list_resources

Listar todos los recursos disponibles o filtrar por tipo.

**Parámetros:**
- `resource_type` (opcional): Filtrar por tipo de recurso. Valores admitidos: `services`, `blog_posts`, `categories`, `jarakube`

**Solicitud**:


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



**Respuesta**:


{
  "resources": [
    {
      "uri": "blog_posts/del-caos-de-datos-a-la-automatizacion-eficiente",
      "name": "Del caos de datos a la automatización eficiente",
      "description": "Cómo transformar...",
      "mimeType": "text/markdown",
      "size": 12345
    }
  ]
}



### read_resource

Leer un recurso específico por URI.

**Solicitud**:


{
  "uri": "blog_posts/del-caos-de-datos-a-la-automatizacion-eficiente"
}



**Respuesta**:


{
  "contents": [
    {
      "type": "text",
      "text": "# Del caos de datos a la automatización eficiente\n\n...",
      "mimeType": "text/markdown"
    }
  ]
}



### call_tool (draft_email)

Redactar un correo electrónico para un servicio.

**Solicitud**:


{
  "name": "draft_email",
  "arguments": {
    "service_slug": "software-development",
    "language": "es",
    "sender_name": "Juan Pérez",
    "sender_email": "juan@example.com",
    "custom_text": "Necesito ayuda con..."
  }
}



**Respuesta**:


{
  "content": [
    {
      "type": "text",
      "text": "{\"subject\": \"Consulta: Servicios de desarrollo de software\", ...}",
      "mimeType": "application/json"
    }
  ],
  "isError": false
}



## Seguridad

- El servidor MCP proporciona **acceso de solo lectura** al contenido
- No se requiere autenticación de forma predeterminada (se puede agregar si es necesario)
- Todas las entradas se validan antes del procesamiento
- El límite de velocidad está configurado para evitar abusos

## Registro MCP

Este servidor está publicado en el registro MCP oficial:

- **Nombre del registro:** `io.github.jrse/jaraco_website`
- **URL del registro:** https://registry.modelcontextprotocol.io
- **Búsqueda:** https://registry.modelcontextprotocol.io/v0.1/servers?search=jaraco

## Soporte

Para preguntas o problemas con el servidor MCP:

- **Correo electrónico**: info@jaraco.de
- **Sitio web**: https://jarakube.eu
- **GitHub**: https://github.com/jaracogmbh/jarakube-jaraco-app

## Historial de versiones

- **1.0.1**: Documentación actualizada, publicada en el registro MCP
- **1.0.0**: Versión inicial con publicaciones de blog, servicios, categorías y redacción de correos electrónicos