Agregador RSS de MCP

Características

• Lee artículos de tus feeds RSS favoritos directamente en Claude Desktop

• Compatibilidad con archivos OPML para importar sus suscripciones de feeds existentes

• Organizar feeds por categorías

• Recibe los últimos artículos en todos tus feeds

• Filtrar artículos por fuente de alimentación o categoría

• Presentación de artículos bien formateados con títulos, fragmentos y enlaces.

Related MCP server: @kazuph/mcp-pocket

Manifestación

Haga clic en cualquier marca de tiempo para saltar a esa sección del video.

00:00 - Demostración de un ejemplo de fuente RSS : Uso del archivo predeterminado 'sample-feeds.opml' incluido en el repositorio. Este segmento muestra cómo Claude procesa y presenta noticias de fuentes como TechCrunch, The Verge y otras publicaciones tecnológicas mediante el MCP (Protocolo de Contexto de Modelo).

01:05 - Proceso de edición del archivo de configuración : tutorial paso a paso sobre cómo acceder y modificar el archivo claude_desktop_config.json para cambiar la referencia de la ruta del archivo OPML de la muestra predeterminada a un archivo 'my-feeds.opml' personalizado.

01:15 - Procedimiento de reinicio de la aplicación : ilustra el paso necesario para cerrar y volver a abrir la aplicación Claude Desktop para cargar y aplicar correctamente los cambios de configuración del archivo OPML modificado.

01:25 - Resultados de la fuente RSS personalizada : Demostración de los resultados tras implementar el archivo OPML personalizado. Esta sección destaca las fuentes de noticias ampliadas y más diversas ahora disponibles a través de Claude Desktop, incluyendo contenido en español.

Requisitos

• Node.js 16 o superior

• Escritorio de Claude

• Conexión a Internet para acceder a las fuentes RSS

Instalación

Instalación manual

1. Clonar o descargar este repositorio:

git clone https://github.com/imprvhub/mcp-rss-aggregator
cd mcp-rss-aggregator

2. Instalar dependencias:

npm install

3. Construir el proyecto:

npm run build

Configuración de la fuente

El agregador RSS admite los formatos OPML y JSON para la configuración de fuentes.

Uso de OPML (recomendado)

OPML (Outline Processor Markup Language) es un formato estándar utilizado por la mayoría de los lectores RSS para exportar e importar suscripciones a feeds.

Se incluye un archivo OPML de muestra con feeds populares en el archivo public/sample-feeds.opml . Puedes:

1. Utilice este archivo tal como está

2. Edítalo para agregar tus propios feeds

3. Reemplácelo con una exportación de su lector RSS existente

La mayoría de los lectores RSS le permiten exportar sus suscripciones como un archivo OPML.

Usando JSON

Alternativamente, puede definir sus feeds en un archivo JSON con el siguiente formato:

[
  {
    "title": "Hacker News",
    "url": "https://news.ycombinator.com/rss",
    "htmlUrl": "https://news.ycombinator.com/",
    "category": "Tech News"
  },
  {
    "title": "TechCrunch",
    "url": "https://techcrunch.com/feed/",
    "htmlUrl": "https://techcrunch.com/",
    "category": "Tech News"
  }
]

Ejecución del servidor MCP

Hay dos formas de ejecutar el servidor MCP:

Opción 1: Ejecutar manualmente

1. Abra una terminal o un símbolo del sistema

2. Navegar al directorio del proyecto

3. Ejecute el servidor directamente:

node build/index.js

Mantenga esta ventana de terminal abierta mientras usa Claude Desktop. El servidor se ejecutará hasta que cierre la terminal.

Opción 2: Inicio automático con Claude Desktop (recomendado para uso habitual)

El Escritorio Claude puede iniciar automáticamente el servidor MCP cuando sea necesario. Para configurarlo:

Configuración

El archivo de configuración de Claude Desktop se encuentra en:

• macOS : ~/Library/Application Support/Claude/claude_desktop_config.json

• Ventanas : %APPDATA%\Claude\claude_desktop_config.json

• Linux : ~/.config/Claude/claude_desktop_config.json

Edite este archivo para agregar la configuración del MCP del Agregador RSS. Si el archivo no existe, créelo:

{
  "mcpServers": {
    "rssAggregator": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_DIRECTORY/mcp-rss-aggregator/build/index.js"],
      "feedsPath": "ABSOLUTE_PATH_TO_YOUR_FEEDS_FILE.opml"
    }
  }
}

Notas importantes :

• Reemplace ABSOLUTE_PATH_TO_DIRECTORY con la ruta absoluta completa donde instaló el MCP

  • Ejemplo de macOS/Linux: /Users/username/mcp-rss-aggregator

  • Ejemplo de Windows: C:\\Users\\username\\mcp-rss-aggregator

• Reemplace ABSOLUTE_PATH_TO_YOUR_FEEDS_FILE.opml con la ruta a su archivo OPML o JSON

  • Si se omite, se utilizará el archivo de feeds de muestra

Si ya tiene otros MCP configurados, simplemente agregue la sección "rssAggregator" dentro del objeto "mcpServers":

{
  "mcpServers": {
    "otherMcp1": {
      "command": "...",
      "args": ["..."]
    },
    "rssAggregator": {
      "command": "node",
      "args": [
        "ABSOLUTE_PATH_TO_DIRECTORY/mcp-rss-aggregator/build/index.js"
      ],
      "feedsPath": "ABSOLUTE_PATH_TO_YOUR_FEEDS_FILE.opml"
    }
  }
}

El servidor MCP se iniciará automáticamente cuando Claude Desktop lo necesite, según la configuración de su archivo claude_desktop_config.json .

Uso

1. Reinicie Claude Desktop después de modificar la configuración

2. En Claude, use el comando rss para interactuar con el servidor MCP del agregador RSS

3. El servidor MCP se ejecuta como un subproceso administrado por Claude Desktop

Comandos disponibles

El agregador RSS MCP proporciona una herramienta llamada rss con varios comandos:

Ejemplo de uso

A continuación se muestran varios ejemplos de cómo utilizar el agregador RSS con Claude:

Comandos directos:

rss latest
rss top --20
rss list
rss "Tech News"
rss --hackernews
rss --techcrunch --15

Consultas en lenguaje natural:

También puedes interactuar con el MCP mediante lenguaje natural. Claude interpretará estas solicitudes y usará los comandos adecuados:

• "¿Cuáles son las últimas noticias en Hacker News?"

• "Muéstrame los mejores artículos tecnológicos de hoy"

• "Obtén los últimos artículos de mis feeds de programación"

• "Enumerar todos mis feeds RSS"

Ejemplos de uso extendido

Resumen diario de noticias

Reciba sus noticias de todas sus fuentes:

rss latest --25

Esto recuperará los 25 artículos más recientes en todos sus feeds, lo que le brindará una descripción general rápida de las últimas noticias.

Explorando el contenido principal

Encuentra los artículos más importantes o populares:

rss top --20

Lectura basada en categorías

Centrarse en categorías de contenido específicas:

rss "Tech News" --30
rss "Politics" --15
rss "Science" --10

Actualizaciones específicas de la fuente

Lea actualizaciones de fuentes específicas que sigue:

rss --hackernews --20
rss --nytimes
rss --techcrunch --15

Descubra sus feeds disponibles

Descubra qué feeds tiene configurados:

rss list

Combinando múltiples solicitudes

Puede realizar múltiples solicitudes secuenciales para crear una vista completa:

rss "Tech News" --10
rss "Finance" --10
rss top --5

Flujos de trabajo prácticos

1. Rutina matutina :

   rss top --10
   rss "News" --5

2. Investigación de la industria :

   rss "Industry News" --15
   rss --bloomberg --5

3. Actualizaciones técnicas :

   rss --hackernews --10
   rss --techcrunch --5

Trabajando con Claude

Puedes pedirle a Claude que analice o resuma los artículos:

1. Después de ejecutar: rss latest --10 Pregunta: "¿Puedes resumir estos artículos?"

2. Después de ejecutar: rss "Tech News" --15 Pregunte: "¿Cuáles son las tendencias clave en estos artículos tecnológicos?"

3. Después de ejecutar: rss --nytimes --washingtonpost --10 Pregunta: "Compara cómo estas fuentes cubren los acontecimientos actuales"

Solución de problemas

Error "Servidor desconectado"

Si ve el error "Agregador RSS MCP: Servidor desconectado" en Claude Desktop:

1. Verifique que el servidor esté ejecutándose :

   • Abra una terminal y ejecute manualmente node build/index.js desde el directorio del proyecto

   • Si el servidor se inicia correctamente, utilice Claude mientras mantiene esta terminal abierta

2. Comprueba tu configuración :

   • Asegúrese de que la ruta absoluta en claude_desktop_config.json sea correcta para su sistema

   • Verifique nuevamente que haya utilizado barras invertidas dobles ( \\ ) para las rutas de Windows

   • Verifique que esté utilizando la ruta completa desde la raíz de su sistema de archivos

Herramientas que no aparecen en Claude

Si las herramientas del Agregador RSS no aparecen en Claude:

• Asegúrese de haber reiniciado Claude Desktop después de la configuración

• Verifique los registros de Claude Desktop para detectar cualquier error de comunicación de MCP

• Asegúrese de que el proceso del servidor MCP se esté ejecutando (ejecútelo manualmente para confirmarlo)

Los feeds no se cargan

Si sus feeds no se cargan correctamente:

• Asegúrese de que su archivo OPML/JSON esté correctamente formateado

• Comprueba si el feedsPath en tu configuración es correcto

• Intente ejecutar el servidor manualmente con un archivo de feeds conocido como bueno

Contribuyendo

¡Agradecemos sus contribuciones para mejorar el Agregador RSS! Aquí tiene algunas maneras de contribuir:

1. Añadir compatibilidad con más formatos de feed

2. Mejorar el análisis de feeds y el manejo de errores

3. Añadir más opciones de visualización para los artículos

4. Mejorar las capacidades de categorización y filtrado

Licencia

Este proyecto está licenciado bajo la Licencia Pública de Mozilla 2.0: consulte el archivo de LICENCIA para obtener más detalles.

Enlaces relacionados

• Protocolo de contexto modelo

• Escritorio de Claude