MCP RSS Crawler

Obtiene y almacena en caché fuentes RSS utilizando una base de datos SQLite para su uso con LLMs a través del protocolo MCP.

Documentación

MCP-RSS-Crawler

Un servidor MCP (Protocolo de Cadena de Mensajes) que obtiene fuentes RSS y las comparte con LLMs.

Características

  • Obtención y almacenamiento en caché de fuentes RSS (base de datos SQLite)
  • Implementación del protocolo MCP para una integración fluida con LLMs
  • Soporte para filtrar fuentes por categoría, origen o palabras clave
  • Endpoints API completos para la gestión de fuentes
    • Agregar, actualizar y eliminar fuentes
  • Soporte para obtener artículos desde Firecrawl

Requisitos

  • Bun
  • Clave API de Firecrawl
  • Claude Desktop u otro cliente MCP

Configuración como Servidor MCP

  1. Clona este repositorio
  2. Crea un archivo claude_desktop_config.json basado en claude_desktop_config.json.example con tu configuración
{
  "mcpServers": {
    "rss-crawler": {
      "command": "/path/to/bun",
      "args": ["run", "/path/to/mcp-rss-crawler/apps/mcp-server/src/mcp-cli.ts"],
      "cwd": "/path/to/mcp-rss-crawler",
      "env": {
        "PORT": "5556",
        "DB_DIR": "/path/to/mcp-rss-crawler",
        "FIRECRAWL_API_KEY": "fc-<YOUR_FIRECRAWL_API_KEY>"
      }
    }
  }
}
  1. Instala las dependencias:
    bun install
    
  2. Inicia Claude Desktop:

Protocolo MCP

El servidor implementa el Protocolo de Cadena de Mensajes (MCP) que permite a los LLMs acceder a tus fuentes RSS más recientes. El endpoint MCP acepta solicitudes POST con un cuerpo JSON que contiene un arreglo de mensajes y devuelve una respuesta con los elementos de fuente más recientes.

Ejemplo de solicitud:

{
  "messages": [
    {
      "role": "user",
      "content": "What are the latest news from my RSS feeds?"
    }
  ]
}

Ejemplo de respuesta:

{
  "messages": [
    {
      "role": "assistant",
      "content": "Here are the latest articles from your RSS feeds:",
      "name": "rss-mcp"
    },
    {
      "role": "tool",
      "content": "[{\"title\":\"Article Title\",\"summary\":\"Article summary...\",\"published\":\"2025-03-16T04:30:00.000Z\",\"origin\":\"Feed Name\",\"link\":\"https://example.com/article\"}]",
      "name": "rss-feeds"
    }
  ]
}

Opciones de Configuración

El servidor se puede configurar mediante variables de entorno o un archivo .env:

  • PORT - Puerto del servidor (predeterminado: 5556)
  • FIRECRAWL_API_KEY - Clave API de Firecrawl
  • DB_DIR - Directorio de la base de datos (predeterminado: ~/.mcp-rss-crawler)

Solución de Problemas

  • Para problemas de conexión, verifica la configuración de red y el firewall
  • Los registros están disponibles en la consola y se pueden usar para diagnosticar problemas
  • Para un registro más detallado, establece la variable de entorno DEBUG=mcp-rss:*