Servidor MCP

Jaraco GmbH

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.

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.

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
  • Redactar correos electrónicos: Generar plantillas de correo electrónico específicas de servicios con textos predeterminados apropiados

Recursos disponibles

Tipos de recursos

Tipo Patrón de URI Descripción
Publicaciones de blog blog_posts/{slug}[.{idioma}] Publicaciones de blog individuales
Servicios services/{slug}[.{idioma}] Descripciones de servicios
Categorías categories/{slug} Categorías de contenido

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)

Si no se especifica ningún idioma, se usa inglés de forma predeterminada.

Conexión al servidor MCP

Requisitos previos

  1. Python 3.8 o superior
  2. 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.0
  • SDK MCP: v2.2.0+

Ejemplo de conexión (Python)


from mcp.client import Client

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

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

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

    # 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

Para listar todos los recursos disponibles:



resources = await client.list_resources()



Para listar recursos de un tipo específico:



# Listar solo publicaciones de blog
blog_posts = await client.list_resources("blog_posts/")

# Listar solo servicios
services = await client.list_resources("services/")

# Listar solo categorías
categories = await client.list_resources("categories/")



### Leer recursos

Para leer un recurso específico:



# Leer una publicación de blog
post = await client.read_resource("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("blog_posts/del-caos-de-datos-a-la-automatizacion-eficiente.es")

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

# Leer una categoría
category = await client.read_resource("categories/software-engineering")



### Redactar correos electrónicos

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

| Parámetro | Tipo | Obligatorio | Predeterminado | Descripción |
|-----------|------|-------------|---------------|-------------|
| `service_slug` | string | Sí | - | El identificador del servicio (ej. "software-development") |
| `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 |
|-------------------------------|-------------|
| `software-engineering` | Desarrollo e ingeniería de software |
| `consulting` | Servicios de consultoría |
| `linux` | Servicios de Linux e infraestructura |
| `automation` | Automatización y mejora de flujos de trabajo |

## Referencia de la API

### list_resources

Listar todos los recursos disponibles o filtrar por tipo.

**Solicitud**:


{
  "uri": "blog_posts/"
}



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

## Soporte

Para preguntas o problemas con el servidor MCP:

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

## Historial de versiones

- **1.0.0**: Versión inicial con publicaciones de blog, servicios, categorías y redacción de correos electrónicos