freshrss-mcp
Servidor MCP para FreshRSS que permite a clientes como Claude Code gestionar suscripciones RSS, leer artículos y administrar categorías mediante herramientas estructuradas con autenticación segura.
Ficha actualizada 28 sept 2026, 13:47 · upstream 28 sept 2026, 13:20 · release v0.3.2
Qué es freshrss-mcp
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este servidor MCP conecta clientes de Model Context Protocol con instancias de FreshRSS auto-alojadas, proporcionando acceso programático a feeds RSS y Atom. Habla la API compatible con Google Reader que FreshRSS expone en /api/greader.php, traduciendo identificadores complejos a parámetros utilizables por asistentes.
El servidor ofrece 16 herramientas divididas en lectura (listar feeds, categorías, artículos) y escritura (marcar como leído, suscribirse, importar OPML). Incluye un preset 'essential' con 7 herramientas curadas para mayor fiabilidad. Cada respuesta marca contenido como no confiable con campos estructurados.
Requiere Node.js 22+, configuración de credenciales separada (API password distinto del login web), y soporte para despliegue vía npx, Docker o mcp-hub para clientes que no pueden spawn procesos locales.
- Gestionar suscripciones RSS desde Claude Code o IDEs con autocompletado estructurado
- Leer artículos nuevos sin abrir el navegador de FreshRSS directamente
- Importar/exportar OPML para migrar o sincronizar entre instancias
- Marcar artículos como leídos o favoritos mediante comandos MCP
- Administrar categorías y etiquetas de feeds desde herramientas de automatización
- API compatible con Google Reader que simplifica identificadores complejos a parámetros numéricos
- Preset 'essential' con 7 herramientas curadas para mayor fiabilidad del modelo
- Soporte multiplataforma: npx, Docker (linux/amd64 y arm64), mcp-hub HTTP
- Estructura de salida JSON con campos untrusted y source para validación automática
- Autenticación separada vía API password independiente del login web
- Requiere instancia FreshRSS 1.29+ con API habilitada en configuración
- Necesita credenciales de API password distintas del login web tradicional
- Sin docker-compose, requiere configuración manual de variables de entorno
- Herramientas de escritura requieren confirmación explícita para acciones irreversibles
- Solo soporta Node.js 22 o versiones superiores
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Configurar FRESHRSS_URL, FRESHRSS_USER y FRESHRSS_API_PASSWORD como variables de entorno. Para producción usar HTTPS sin FRESHRSS_INSECURE_TLS=true. Considerar FRESHRSS_ALLOW_TOOLS=essential para reducir superficie de ataque. Imagen Docker disponible en ghcr.io/ni-c/freshrss-mcp:latest con SBOM y provenance.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.