mcp-rss-aggregator

Agregador RSS de MCP

Una integración que permite a Claude Desktop obtener y leer contenido de sus fuentes RSS favoritas utilizando el Protocolo de contexto de modelo (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.

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:

2. Instalar dependencias:

3. Construir el proyecto:

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:

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:

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:

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":

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:

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:

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:

Lectura basada en categorías

Centrarse en categorías de contenido específicas:

Actualizaciones específicas de la fuente

Lea actualizaciones de fuentes específicas que sigue:

Descubra sus feeds disponibles

Descubra qué feeds tiene configurados:

Combinando múltiples solicitudes

Puede realizar varias solicitudes secuenciales para crear una vista completa:

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