n8n Nodes for MCP Server & El Universal News

Este repositorio provee un conjunto de nodos personalizados para n8n, diseñados para interactuar con un servidor MCP (Content Management Platform) y la API de noticias de El Universal. Estos nodos son la base para construir flujos de trabajo automatizados que permiten a los Agentes de IA (impulsados por modelos como Google Gemini) consultar y procesar información periodística de forma inteligente, entregándola posteriormente a una interfaz de usuario como un CLI.

🚀 Características Principales

• MCP Server Noticias EU Tool: Un nodo personalizado que se conecta a una API de noticias externa (configurada para El Universal) para obtener titulares, artículos y contenido periodístico.
  • Propiedades Configurables:
    • API URL: La URL base de la API de noticias (ej., https://api.eluniversal.com.co/servicios-externos/mas-leidas).
    • Search Parameter Name: El nombre del parámetro de consulta en la URL que la API espera para la cadena de búsqueda (ej., q, query, host).
    • News Search String: La cadena de texto específica que se enviará a la API como valor del parámetro de búsqueda (ej., "El Universal Cartagena", "deportes").
  • Construcción de URL: El nodo construye la URL completa de la petición HTTP GET concatenando la API URL con el Search Parameter Name y el News Search String (codificado para URL).
  • Salida JSON Directa: Retorna el resultado de la API en formato JSON crudo, listo para ser procesado por un Agente de IA.

🏗️ Arquitectura del Proyecto

Este proyecto se integra en una arquitectura donde:

1. Nodos Personalizados (n8n-nodes-mcp-server-el-universal): Este repositorio define el nodo MCP Server Noticias EU Tool, que es el "conector" con la API de noticias.
2. n8n Workflow: Un flujo en n8n orquesta la interacción. El nodo MCP Server Noticias EU Tool se utiliza como una "Herramienta" dentro de un nodo Agent.
3. Agente de IA (Google Gemini Chat Model): Configurado en n8n, este Agente interpreta las solicitudes del usuario. Cuando decide que necesita obtener noticias, invoca la herramienta MCP Server Noticias EU Tool y le proporciona el News Search String (o query) basado en la intención del usuario. Luego, procesa el JSON recibido de la herramienta para generar una respuesta formateada y amigable para el usuario final.
4. Interfaz de Usuario (CLI/Otro Cliente): Una aplicación cliente (como "CMP Cliente") interactúa con este flujo de n8n para realizar consultas y mostrar las respuestas.

📋 Requisitos Previos

• Node.js: Versión 18 o superior.
• pnpm: Necesario para el desarrollo y construcción de nodos personalizados de n8n.
• n8n: Una instancia en ejecución de n8n (ya sea local o en la nube).
• Clave de API de Gemini (Google Generative AI): Requerida para configurar el nodo "Google Gemini Chat Model" dentro de n8n, que actúa como el Agente de IA.
• Un servidor MCP compatible: La API de noticias a la que se conectará el nodo. (Ej: https://api.eluniversal.com.co/servicios-externos/mas-leidas).

🛠️ Instalación de Nodos Personalizados en n8n

Para que n8n reconozca y pueda usar estos nodos personalizados:

1. Clona el repositorio:

   git clone [https://github.com/Editora-del-Mar-S-A/n8n-nodes-mcp-server-el-universal](https://github.com/Editora-del-Mar-S-A/n8n-nodes-mcp-server-el-universal)
   cd n8n-nodes-mcp-server-el-universal
   

2. Instala las dependencias del proyecto de nodos:

   npm install
   

3. Compila el proyecto:

   npm run build
   

4. Integra los nodos en tu instancia de n8n:
   • Si estás usando n8n-docker-compose, edita tu archivo docker-compose.override.yml o docker-compose.yml para mapear el volumen de tu repositorio al directorio de nodos personalizados de n8n (/root/.n8n/custom).
   • Si instalaste n8n directamente, puedes mover o enlazar los archivos compilados (dist y nodes) a la ubicación de nodos personalizados de n8n (normalmente ~/.n8n/custom/).
   • Consulta la documentación oficial de n8n sobre nodos personalizados para obtener instrucciones detalladas.
5. Reinicia tu instancia de n8n para que cargue los nuevos nodos.

💡 Uso en un Flujo de n8n

Una vez instalados, puedes encontrar el nodo MCP Server Noticias EU Tool en el diseñador de flujos de n8n.

Para un uso efectivo con el Agente de IA:

1. Configura el nodo MCP Server Noticias EU Tool:

   • API URL: Establece la URL base de tu API de noticias.
   • Search Parameter Name: Define el nombre del parámetro que tu API usa para las búsquedas (ej., q, query, host).
   • News Search String: Puedes dejar un valor predeterminado para pruebas, pero este valor será sobrescrito por lo que el Agente de IA le proporcione (el query del usuario).

2. Conecta el nodo a un Agent: El Agente de IA (usando un modelo como Google Gemini) será el que decida cuándo invocar esta herramienta.

3. Configura el Agent: Proporciona el prompt actualizado (el que hemos estado afinando) en la configuración del Agente (System Message o Instructions). Este prompt le dirá al Agente cómo usar tu herramienta, indicando que requiere un parámetro de búsqueda (query) y que el Agente debe obtenerlo de la interacción con el usuario.

   Ejemplo de cómo el Agente invocará la herramienta (internamente):
   Cuando el usuario solicite "noticias de deportes en Cartagena", el Agente interpretará esto y, si se configuró correctamente, llamará a la herramienta de esta manera (o similar, dependiendo de la configuración interna de LangChain y cómo el Agente mapea query a queryString):
   MCP Server Noticias EU Tool(queryString='deportes Cartagena')

🔧 Desarrollo de Nodos (Opcional)

Si deseas modificar o extender los nodos:

• Requisitos: Node.js, pnpm, git, y n8n.
• Documentación oficial: Consulta la documentación de n8n para crear nodos personalizados.

Licencia

MIT