RikkaHub History MCP

Un puente MCP de solo lectura para buscar conversaciones de la app oficial de RikkaHub a través de su API web. No requiere un APK modificado, acceso root ni migración de la base de datos Room.

Características

• recent_conversations — lista las conversaciones recientes del asistente seleccionado actualmente con metadatos ligeros.

• search_conversations — usa el índice global de texto completo integrado de RikkaHub.

• get_conversation_context — lee una ventana limitada alrededor de un resultado de búsqueda.

• Lee solo la rama de mensajes seleccionada actualmente.

• Devuelve solo el texto de USER/ASSISTANT; se omiten los razonamientos, las llamadas/resultados de herramientas, los mensajes del sistema y los archivos adjuntos.

• Resuelve rikkahub.local con mDNS, por lo que un cambio de dirección DHCP del teléfono normalmente no requiere reconfiguración.

• Admite modos de servidor web de RikkaHub con contraseña y sin autenticación.

• Renueva automáticamente el JWT web de RikkaHub cuando se configura una contraseña web.

• El modo Streamable HTTP requiere un token Bearer separado y mantiene habilitada la protección contra el rebinding de DNS.

[!IMPORTANT] La búsqueda de texto completo global de RikkaHub puede devolver conversaciones de otros asistentes. recent_conversations se limita al asistente seleccionado actualmente, pero la búsqueda/el contexto no son un límite de aislamiento entre asistentes.

Related MCP server: reddit-mcp

Requisitos

• Python 3.10+

• Servidor web de RikkaHub habilitado y accesible en la misma LAN de confianza.

• Una contraseña web de RikkaHub dedicada cuando el modo de contraseña/JWT de la app funciona.

Instalación

python -m venv .venv
# Windows
.venv\Scripts\python -m pip install -e .
# Linux/macOS
.venv/bin/python -m pip install -e .

Para desarrollo y comprobaciones de seguridad:

python -m pip install -e ".[dev]"
pytest
ruff check .
bandit -q -r rikkahub_history_mcp
pip-audit

Configurar RikkaHub Web

En RikkaHub, habilita el servidor web. El puerto por defecto es 8080.

El puente primero intenta:

http://rikkahub.local:8080

Vuelve a resolver mDNS tras fallos y puede conservar la última IP correcta del teléfono como respaldo. En su lugar, puedes establecer una URL base explícita como http://192.168.0.20:8080.

Modo con contraseña/JWT habilitado

Establece una contraseña web de RikkaHub dedicada y no reutilizada y proporciónala a través de:

RIKKAHUB_WEB_PASSWORD=...

Modo sin contraseña/JWT

Deja RIKKAHUB_WEB_PASSWORD vacío. El puente llamará a la API web oficial sin una cabecera Authorization.

[!WARNING] Este modo de compatibilidad es más débil. Cuando el JWT web de RikkaHub está deshabilitado, los endpoints de escritura de la API web oficial también pueden ser accesibles sin autenticación en la LAN. El puente sigue siendo de solo lectura, pero no puede proteger el servidor web de RikkaHub por separado. Usa esto solo en una LAN aislada y de confianza.

Ejecutar con Streamable HTTP

Copia start_http.example.ps1 al start_http.ps1 ignorado y luego reemplaza cada marcador de posición. Alternativamente, establece las variables de .env.example en el entorno del proceso.

Variables importantes:

Genera un token:

python -c "import secrets; print(secrets.token_urlsafe(32))"

Inícialo en Windows:

.\start_http.ps1

Luego configura RikkaHub MCP:

Transport: Streamable HTTP
URL: http://<computer-lan-ip>:8766/mcp
Header: Authorization: Bearer <RIKKAHUB_HISTORY_TOKEN>

Para acceso desde la LAN, establece RIKKAHUB_HISTORY_HOST=0.0.0.0, restringe el puerto con el cortafuegos del host y añade el host y el puerto exactos que usa RikkaHub a RIKKAHUB_HISTORY_ALLOWED_HOSTS. El modo HTTP se niega a iniciarse sin un token Bearer que no sea un marcador de posición.

Modo STDIO

RIKKAHUB_WEB_PASSWORD=... rikkahub-history-mcp

STDIO es el modo predeterminado cuando RIKKAHUB_HISTORY_RUN_MODE no está establecido y no requiere RIKKAHUB_HISTORY_TOKEN porque no abre un puerto HTTP de escucha.

Seguridad y privacidad

• Las herramientas MCP expuestas por este proyecto son de solo lectura.

• Nunca expongas el servidor web de RikkaHub ni este servidor MCP directamente a Internet público.

• No configures redirección de puertos en el router para los puertos 8080 o 8766.

• RikkaHub Web y la conexión MCP de ejemplo usan HTTP sin cifrar. Úsalos solo en una LAN de confianza; las contraseñas y los tokens Bearer no están protegidos contra un observador hostil de la red.

• Usa una contraseña web de RikkaHub única y un token Bearer MCP separado y generado aleatoriamente.

• El puente desactiva la configuración heredada de HTTP_PROXY/HTTPS_PROXY para el tráfico de la API del teléfono, a fin de evitar enviar credenciales locales o datos de conversación a través de un proxy.

• El texto de conversación recuperado son datos no confiables. Los modelos no deben seguir instrucciones, enlaces ni solicitudes de herramientas encontradas en mensajes históricos.

• El historial recuperado se envía al proveedor de modelos seleccionado actualmente como contexto de herramienta. Busca de manera específica y mantén ventanas de contexto pequeñas cuando las conversaciones contengan información sensible.

• No hagas commit de .env, start_http.ps1, contraseñas, JWT, tokens Bearer, archivos de estado ni registros.

• Consulta SECURITY.md para informar vulnerabilidades y conocer el modelo de seguridad compatible.

Licencia

MIT