Yomi (読み) — el servidor MCP personal de LINE

Yomi es un servidor MCP de LINE de código abierto para tu cuenta personal. Lee, responde, envía imágenes y busca en cualquier conversación desde Claude o cualquier agente de IA local — sin navegador, sin cuenta de bot y sin el cliente propio de LINE.

El nombre se lee de más de una manera. 読み (yomi) — una lectura: no solo analizar tus mensajes, sino leer la situación, como haces tú. 詠み (yomi) — recitar: no lee en silencio, te lee las cosas de vuelta. Y 黄泉 (yomi) — el reino inalcanzable; el mismo yomi en 黄泉帰り (yomigaeri), "regresar de Yomi". Como un mensajero que se mueve entre dos reinos, Yomi atraviesa sellos y silencios para traer de vuelta a la luz mensajes que siguen siendo legibles en lo profundo de tus conversaciones. No invoca una historia ya perdida; ayuda a que lo que no ha desaparecido se vuelva a ver.

A diferencia del servidor MCP oficial de Bot de LINE, que conecta agentes de IA a una cuenta oficial de LINE a través de la Messaging API, Yomi se conecta a tu cuenta personal existente de LINE y a tus conversaciones como un dispositivo secundario.

Yomi habla directamente el protocolo TCompact-over-HTTPS de LINE, descifra los mensajes y multimedia con Letter-Sealing (E2EE), y expone el resultado a cualquier agente de IA a través de un pequeño servidor MCP stdio. Apunta Claude Desktop (o cualquier cliente MCP) hacia él y el agente podrá ponerse al día con tu LINE como lo harías tú: leer, responder, enviar una imagen, mencionar a alguien y buscar en todo tu historial localmente — y, con get_insight, leer la situación: qué conversaciones están esperando tu respuesta, quién une tu mundo y qué ha quedado pendiente.

Sin API oficial, sin cuenta de bot, sin webhook. Yomi inicia sesión como dispositivo secundario en tu propia cuenta.

Guías: ¿Qué es un servidor MCP de LINE? · LINE MCP 是什麼？Yomi、官方 Bot 與桌面自動化的差異.

No oficial. Yomi es un proyecto personal independiente, no afiliado ni respaldado por LINE. Su uso puede ir contra los Términos de Servicio de LINE, y ejecutar un cliente adicional en tu cuenta conlleva un riesgo de limitación de velocidad o suspensión. Está pensado para leer tu propia cuenta. Úsalo bajo tu propio riesgo. Consulta Aviso legal.

Primeros pasos

Vista previa de Native Desktop

Yomi Desktop pone la bandeja de entrada de LINE y el espacio de trabajo del agente local en una sola aplicación nativa. Incluye su propio runtime: los usuarios no instalan Node, no abren Terminal, no clonan este repositorio ni configuran YOMI_RUN_MJS. Native Desktop es independiente de la extensión MCPB de Claude Desktop que se describe a continuación.

El paquete de macOS se ha probado a través de la ruta real de aplicación descargada: DMG en cuarentena, instalación en /Applications, evaluación de Gatekeeper, primer arranque, actualización de mensajes con el runtime incluido y formulario de inicio de sesión de LINE sin terminal. El instalador de Windows contiene el flujo equivalente de inicio de sesión por teléfono/PIN dentro de la aplicación y se prueba en un runner nativo de Windows antes del lanzamiento.

Las compilaciones de Desktop son experimentales y no oficiales. Los cambios de LINE pueden romperlas, y ejecutar un cliente adicional puede poner en riesgo una cuenta. Prefiere una cuenta de prueba y mantén una copia de seguridad actualizada. Los instaladores de vista previa se publican como pre-lanzamientos de GitHub solo después de que la firma de la plataforma esté disponible.

Consulta el proceso de lanzamiento de desktop, la política de firma de código y la política de privacidad.

Servidor MCP y extensión de Desktop

Necesitas Node.js y una cuenta de LINE. Yomi se ejecuta localmente a través de npx; no necesitas clonar este repositorio, instalar Bun ni compilar nada. Ejecuta primero node --version e instala la LTS actual si el comando no existe o la versión no es compatible.

El índice de búsqueda local de Yomi usa el node:sqlite integrado de Node, por lo que necesita v22.13 o más reciente — excepto v23.0–v23.3, que son más recientes que v22.13 pero aún carecen de ese módulo (se desmarcó tanto en 22.13.0 como en 23.4.0). Cualquier LTS actual es válida. Esto es engines.node en package.json; el resto de Yomi funciona en Node más antiguo, pero la búsqueda, el alcance y la captura no.

⚠️ Yomi necesita un cliente que lo ejecute en tu propia máquina. Las herramientas solo en la nube (ChatGPT, Claude.ai web) no pueden ejecutar Yomi. Configura Yomi en Claude Desktop o Claude Code y funcionará tanto en el chat como en Cowork, porque Desktop inicia Yomi en tu máquina y las sesiones locales de Cowork lo cargan. No le pidas a Cowork que instale Yomi por ti: el shell de Cowork se ejecuta dentro de una VM desechable, no en tu máquina, así que cualquier cosa que instale allí desaparece cuando termina la sesión. Sigue los pasos de abajo tú mismo, en tu propia terminal.

Elige el cliente que realmente usas y sigue solo esa sección. Claude Code y Claude Desktop tienen ajustes de MCP separados; configurar uno no configura el otro.

La ruta más fácil, y la única que no requiere línea de comandos en absoluto. Claude Desktop incluye su propio runtime de Node, así que no hay que instalar nada más.

1. Descarga el paquete para tu máquina desde el último lanzamiento:

   Máquina	Archivo
   Windows (Intel/AMD)	yomi-win32-x64.mcpb
   Mac (Apple Silicon)	yomi-darwin-arm64.mcpb
   Linux (x64)	yomi-linux-x64.mcpb

2. En Claude Desktop, abre Settings → Extensions y arrastra el archivo descargado a esa página (o simplemente haz doble clic en el archivo).

3. Revisa lo que te pide, haz clic en Install.

4. Inicia una conversación y di "log in to LINE". Yomi muestra un formulario, introduces tu número de teléfono y lo confirmas en tu teléfono. Sin terminal en ningún momento.

Esto omite por completo el archivo de configuración, lo que también evita el error de MSIX de Windows que se describe a continuación.

Nota para usuarios de Cowork: no le pidas a Cowork que instale Yomi por ti. El shell de Cowork se ejecuta dentro de una VM desechable — no en tu máquina — y no escribirá en tu terminal real. Instala el paquete tú mismo con los tres clics de arriba; una vez instalado, las sesiones locales de Cowork pueden usar Yomi como cualquier otra herramienta.

1. Encuentra la ruta completa a npx:

   macOS / Linux: which npx
   Windows:       where npx

2. Abre el archivo de configuración de Claude Desktop:

   macOS:   ~/Library/Application Support/Claude/claude_desktop_config.json
   Windows: %APPDATA%\Claude\claude_desktop_config.json

   ⚠️ Windows: la ruta documentada puede no ser la que Claude realmente lee. Claude Desktop se distribuye como un paquete MSIX, cuyo sistema de archivos está virtualizado. La aplicación lee su configuración de

   %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json

   mientras que Settings → Developer → Edit Config abre el archivo no virtualizado %APPDATA%\Claude\. Son dos archivos diferentes que nunca se sincronizan, así que una configuración correcta de Yomi escrita en la ruta documentada se ignora silenciosamente — sin error, sin registro, Yomi simplemente nunca aparece. Esto es claude-code#26073, aún abierto. Si Yomi no aparece después de un reinicio, escribe la misma configuración en la ruta LocalCache de arriba también. (No aplica a Claude Code, ni a Desktop instalado fuera de MSIX.)

3. Añade Yomi bajo mcpServers, reemplazando el command de ejemplo con la ruta completa impresa en el paso 1. En Windows, JSON requiere que cada \ de la ruta se escriba como \\:

{
  "mcpServers": {
    "yomi": {
      "command": "/opt/homebrew/bin/npx",
      "args": ["@rikaidev/yomi"]
    }
  }
}

Por ejemplo, una ruta de Windows puede verse como "C:\\Program Files\\nodejs\\npx.cmd". Usa la ruta que informe tu propia máquina en lugar de copiar cualquiera de los ejemplos a ciegas.

⚠️ El npx que nombres aquí no decide qué Node ejecuta Yomi. En macOS y Linux, npx es un script que comienza con #!/usr/bin/env node, así que ejecuta el node que aparezca primero en el PATH de Claude Desktop — no el Node instalado junto al npx al que acabas de apuntar. Desktop hereda su PATH de la sesión de escritorio, que a menudo no es la de tu terminal, y los gestores de versiones (nvm, fnm, asdf, volta, …) ponen su propio node por delante de todo lo demás. Así que which npx puede informar una instalación perfectamente moderna mientras Yomi sigue arrancando con un Node antiguo.

El síntoma es específico: iniciar sesión, leer y enviar funcionan, pero la búsqueda, el alcance y la captura fallan, y el registro dice No such built-in module: node:sqlite. Yomi imprime el runtime que realmente obtuvo en ese error — léelo en lugar de asumir.

La solución es darle al servidor un PATH cuya primera entrada contenga un node compatible:

"yomi": {
  "command": "<the npx path from step 1>",
  "args": ["-y", "@rikaidev/yomi"],
  "env": { "PATH": "<dir holding a supported node><sep><a base PATH>" }
}

Separador: : en macOS/Linux, ; en Windows. Mantén una base utilizable después (/usr/local/bin:/usr/bin:/bin o el equivalente de tu plataforma) — esto reemplaza el PATH del servidor en lugar de anteponerlo, y npx necesita las herramientas habituales.

Nombrar un node absoluto en command no funciona, por muy plausible que parezca: npx lanza el bin propio del paquete como proceso hijo y resuelve node desde PATH de nuevo para él, así que command solo elige quién ejecuta npx, no quién ejecuta Yomi. Establecer PATH es lo que realmente llega al servidor.

¿Configurando esto con un agente de IA? Las configuraciones de MCP ahora las escriben más los agentes que a mano, así que los pasos anteriores están redactados para un humano que lee su propia máquina. Un agente debería resolver los valores en lugar de emitir marcadores de posición, y esta configuración tiene una trampa que vale la pena señalar directamente: nombrar npx en command no fija el runtime. Procedimiento:

1. Encuentra un Node que realmente tenga el módulo que el índice de Yomi necesita; no lo infieras a partir de un número de versión:

node -e 'require("node:sqlite")' && command -v node    # POSIX
node -e "require('node:sqlite')" && where node         # Windows

Si lanza una excepción, ese Node no sirve para búsqueda/alcance/captura. Prueba las otras instalaciones (which -a node, nvm ls, fnm list, …) hasta que una pase; solo entonces continúa.

2. Escribe el directorio de ese Node en env.PATH, según el JSON anterior, y mantén un PATH base después. Resuelve el directorio en la máquina de destino (dirname de la ruta del paso 1); no copies un ejemplo de este README: son rutas de Homebrew para Apple Silicon y están mal en casi todas partes.

No pongas en su lugar un node absoluto en command. Parece la solución más robusta y no lo es: npx lanza el bin del paquete como un proceso hijo y vuelve a resolver node desde PATH para él, así que command solo decide quién ejecuta npx. Esto se midió, no se asumió: con un Node 20 primero en PATH, fijar command seguía dándole al servidor Node 20.

command -v también puede devolver un envoltorio en lugar de un binario real: los shims de heap, los envoltorios de npx locales y los stubs de gestores de versiones son comunes, y algunos se comportan de manera diferente según el directorio de trabajo del cliente. No intentes razonar cuál es el "real". El paso 3 lo resuelve.

3. Verifica con una herramienta que toque el índice. yomi version no es una verificación: imprime una cadena sin abrir SQLite, por lo que tiene éxito en un Node que no puede ejecutar búsquedas. Llama a get_scope_policy: necesita SQLite y no requiere inicio de sesión en LINE. Si devuelve el texto de la política, el runtime es correcto. Si falla, el error nombra el Node que realmente se ejecutó y lo que necesitaba.

4. Cierra y vuelve a abrir Claude Desktop por completo. Confirma que Yomi está cargado en Configuración → Desarrollador antes que cualquier otra cosa: si Yomi no aparece allí, Claude nunca leyó tu configuración; en Windows, consulta la advertencia de MSIX en el paso 2. Una vez que aparezca, las herramientas están disponibles tanto en el chat como en las sesiones locales de Cowork.

No necesitas instalar Claude Code para esta configuración.

claude mcp add yomi -- npx @rikaidev/yomi

Inicia una nueva sesión de claude. Las herramientas de Yomi deberían aparecer automáticamente. Este comando configura solo Claude Code; no configura Claude Desktop.

Esta forma deja el runtime a PATH, lo cual está bien siempre que el node que resuelve tu sesión de claude sea uno compatible: es el mismo PATH que puedes ver, a diferencia del de Claude Desktop. Compruébalo con node -e 'require("node:sqlite")'. Si lanza una excepción, o prefieres no depender de PATH en absoluto, nombra el Node explícitamente:

claude mcp add yomi -e PATH="$(dirname "$(command -v node)"):$PATH" -- npx -y @rikaidev/yomi

En cualquier caso, verifica con get_scope_policy en lugar de yomi version: el comando de versión imprime una cadena sin abrir SQLite, por lo que pasa en un Node que no puede ejecutar búsquedas.

¿Ejecutando Claude Code dentro de un clon de este repositorio? Escribe la especificación @rikaidev/yomi@latest. Sin una etiqueta, npx busca primero un bin local, y en este repositorio package.json declara "bin": {"yomi": ...} mientras que nada lo enlaza en node_modules/.bin; así que npx omite la instalación y muere con sh: yomi: command not found. Una etiqueta explícita hace que obtenga el paquete publicado. Solo afecta a las copias de trabajo de Yomi; en cualquier otro lugar, la forma sin etiqueta está bien.

Esta configuración estándar funciona en la mayoría de los clientes MCP:

{
  "mcpServers": {
    "yomi": {
      "command": "npx",
      "args": ["@rikaidev/yomi"]
    }
  }
}

Cursor Settings → MCP → Add new MCP Server → nómbralo yomi, tipo de comando, valor: npx @rikaidev/yomi

O añádelo a .cursor/mcp.json en la raíz de tu proyecto.

Añádelo a .vscode/mcp.json:

{
  "servers": {
    "yomi": {
      "command": "npx",
      "args": ["@rikaidev/yomi"]
    }
  }
}

Añádelo a ~/.config/opencode/opencode.json:

{
  "mcp": {
    "yomi": {
      "type": "local",
      "command": ["npx", "@rikaidev/yomi"],
      "enabled": true
    }
  }
}

codex mcp add yomi npx @rikaidev/yomi

O añádelo a ~/.codex/config.toml:

[mcp_servers.yomi]
command = "npx"
args = ["@rikaidev/yomi"]

Añádelo a cline_mcp_settings.json:

{
  "mcpServers": {
    "yomi": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@rikaidev/yomi"]
    }
  }
}

Añádelo a ~/.codeium/windsurf/mcp_config.json — el mismo JSON que la configuración estándar.

amp mcp add yomi -- npx @rikaidev/yomi

Advanced settings → Extensions → Add custom extension → nómbralo yomi, tipo STDIO, comando: npx @rikaidev/yomi

grok mcp add yomi -- npx @rikaidev/yomi

Primer inicio de sesión

Una vez conectado, dile al agente:

"Inicia sesión en LINE: mi número es +8869XXXXXXXX."

Aprueba el dispositivo en tu teléfono (consulta Iniciar sesión), y:

"Resume mi LINE no leído y dime quién está esperando una respuesta."

Related MCP server: line-desktop-mcp

Lo que puedes hacer

Yomi expone 20 herramientas a través de MCP (las que merece la pena nombrar; consulta las tablas). Los resultados de lectura grandes usan TOON, eficiente en tokens; los resultados de estado y escritura pequeños usan JSON compacto. Los errores siguen siendo texto plano y los medios usan contenido nativo de imagen/audio/recurso de MCP.

"Error honesto" a continuación significa un fallo explícito que nombra el problema (p. ej., missing_decrypt_material): Yomi nunca fabrica un respaldo, un marcador de posición ni un éxito falso.

Lectura

Información (lee la situación, no solo los mensajes)

Escritura (estos realmente envían, no borradores)

Búsqueda (local, entre conversaciones: LINE no tiene tal primitiva)

Alcance y privacidad (todo funciona sin conexión, no se necesita sesión de LINE)

Sesión

Iniciar sesión

Requisito previo: en tu teléfono principal, activa 設定 › 我的帳號 › 允許自其他裝置登入 (Ajustes › Cuenta › Permitir inicio de sesión en otros dispositivos). Sin esto, LINE nunca ofrece a este dispositivo un aviso de inicio de sesión: esta es la causa más común de que un primer inicio de sesión parezca quedarse colgado.

⚠️ Límite de una sola sesión de escritorio: LINE solo permite una sesión de cliente de escritorio a la vez por cuenta. Como Yomi se conecta como dispositivo secundario de escritorio (DESKTOPMAC), iniciar sesión en Yomi cerrará la sesión de tu aplicación oficial LINE Desktop (y volver a iniciar sesión en LINE Desktop invalidará la sesión de Yomi). No puedes usar Yomi y el cliente oficial LINE Desktop simultáneamente.

Solo necesitas darle al agente tu número de teléfono en formato E.164: él mismo proporciona la región (p. ej. TW para un número +886) cuando llama a la herramienta.

Yomi gestiona el flujo sin contraseña (dispositivo secundario) de LINE. Cómo se presenta el inicio de sesión depende de tu cliente MCP:

• Clientes con la capacidad MCP elicitation — login te pide tu teléfono/región, muestra el PIN en un diálogo y se bloquea hasta completarse. Una sola llamada, sin PIN transmitido a través del modelo. Tu número de teléfono nunca entra en la transcripción.

• Clientes sin esa capacidad (p. ej. Claude Desktop hoy) — dos llamadas. login (con tu teléfono + región) devuelve el PIN en su resultado; introdúcelo en LINE en tu teléfono principal y aprueba el dispositivo; luego llama a login_complete, que se bloquea hasta que el teléfono confirma. El agente debe llamar a login_complete inmediatamente: es él quien espera, así que no hay nada que debas informar.

• Desde una terminal — npx @rikaidev/yomi login ejecuta todo el flujo en stdout, PIN incluido. Siempre disponible como alternativa.

La única fecha límite que importa es la de LINE: tienes unos 3 minutos desde que se muestra el PIN para introducirlo y aprobar el dispositivo. El propio cliente de Yomi sigue escuchando durante muchos minutos más, así que un teléfono lento nunca es el fallo: solo la vida útil de 3 minutos del código de LINE lo es.

Una vez que has iniciado sesión, la sesión — incluido un certificado de inicio de sesión — se persiste (ver más abajo), y los futuros inicios de sesión se saltan el PIN por completo.

También hay una interfaz experimental de MCP Apps (una tarjeta ui://yomi/login) para clientes que renderizan vistas interactivas. Es correcta según la especificación y se renderiza bajo MCP Inspector, pero algunos hosts obtienen el recurso sin completar el protocolo de la vista, por lo que es solo de visualización y nunca está en la ruta crítica — los flujos anteriores siempre funcionan independientemente.

Sesiones y credenciales

Yomi gestiona su propio inicio de sesión. Al arrancar, llama a resumeSession() una vez, leyendo la sesión de LINE del Llavero de macOS (servicio dev.rikai.yomi.credentials, cuenta line) y renovando silenciosamente el token si es necesario.

• Credenciales de primera parte. El inicio de sesión sin contraseña persiste el token de autenticación, el token de renovación, el certificado, el MID y el propio par de claves E2EE — y luego los lee de nuevo para verificar que la escritura realmente se realizó. Un inicio de sesión que no se puede persistir falla de forma visible al iniciar sesión, no silenciosamente en el siguiente reinicio.

• Sesión compartida. La sesión se almacena en la entrada canónica del llavero dev.rikai.yomi.credentials (o en el almacén de credenciales local), lo que permite que Yomi MCP y Yomi Desktop compartan exactamente la misma sesión de inicio de sesión de LINE sin problemas.

• Nota de plataforma. En macOS, la sesión vive en el llavero de inicio de sesión. En Linux y Windows, Yomi actualmente recurre a un archivo JSON local: funcional, pero menos protegido que un almacén de secretos del sistema operativo, y menos probado que la ruta de macOS. Se planean backends nativos de almacenamiento seguro (libsecret / DPAPI); hasta entonces, trata una instalación que no sea de macOS en consecuencia.

Toda herramienta excepto login y las herramientas de alcance/búsqueda sin conexión devuelve un error honesto cuando no hay sesión. Por lo demás, Yomi es un servidor de consultas puro: nunca sondea, nunca rellena datos en segundo plano; cada llamada a una herramienta hace exactamente las solicitudes a LINE que necesita, y collect_messages es la única vía que obtiene datos de muchos chats a la vez.

Búsqueda

LINE no tiene búsqueda entre conversaciones; Yomi construye una localmente. El índice es una base de datos SQLite ignorada por git (data/search-index.db) en el repositorio — nada sale de tu máquina.

La búsqueda es híbrida por diseño. Siempre ejecuta búsqueda por palabras clave FTS5 (bm25 sobre texto preprocesado con bigramas, de modo que las subcadenas CJK sin límites de palabras están cubiertas) y, cuando existen incrustaciones, búsqueda semántica, y luego fusiona las dos listas clasificadas mediante Fusión de Rango Recíproco. La búsqueda puramente semántica pierde silenciosamente coincidencias exactas que viven en mensajes no incrustados; la búsqueda puramente por palabras clave pierde paráfrasis; fusionar ambas muestra un término exacto y una coincidencia de significado juntos. El campo mode de la respuesta siempre informa qué métodos contribuyeron.

La clasificación semántica mantiene cada mensaje como su propio vector. Las pruebas con conversaciones reales indexadas de LINE encontraron que incrustar ventanas de conversación superpuestas diluía el mensaje central y reducía la calidad de recuperación. Por lo tanto, el contexto se añade solo después de la clasificación: Yomi limita que un solo chat inunde los resultados principales y expande cada ganador con dos mensajes a cada lado para que el agente vea el intercambio que dio significado a la coincidencia sin debilitar la propia incrustación.

La clasificación semántica usa Xenova/bge-small-zh-v1.5 (incrustación general de BAAI, pequeña, principalmente en chino pero multilingüe) mediante transformers.js. La inferencia de incrustación se ejecuta completamente en proceso en CPU: el texto de tus mensajes nunca se envía a ningún sitio.

La única salvedad es una descarga única del modelo: en el primer collect_messages o search_messages, transformers.js descarga el modelo (~90 MB) de huggingface.co y lo almacena en caché localmente; cada ejecución posterior es totalmente sin conexión. Esa primera descarga es una solicitud HTTPS saliente a HuggingFace por los pesos del modelo: lleva tu IP y qué modelo se está descargando, pero ningún contenido de mensajes ni datos de LINE. Si necesitas Yomi completamente aislado, precarga la caché de transformers.js (o apúntala a un directorio de modelos local) antes de la primera búsqueda para que nunca se haga ninguna llamada de red.

La realidad del dispositivo secundario (léelo antes de confiar en "no puedo obtener mensajes antiguos")

Yomi se ejecuta como un dispositivo secundario en tu cuenta. Eso determina lo que puede ver:

• Los chats de grupo sin Letter Sealing son texto plano en el servidor de LINE — historial completo y medios, sin restricción.

• Los chats de grupo con Letter Sealing son E2EE, y ahí la época importa. Un grupo así está cifrado con una clave de grupo compartida que rota (con cambios de membresía, o cuando un cliente aprovisiona una nueva). LINE solo entrega a un dispositivo la actual clave de grupo: no hay API para obtener una reemplazada. Así que un dispositivo secundario descifra mensajes de la época cuya clave posee en adelante; los mensajes enviados bajo una época anterior — antes de que Yomi obtuviera la clave actual — pueden volver indescifrables, incluso en un grupo cuyo historial anterior sí puede leer. Esto es inherente a las claves de grupo por época de Letter Sealing, no un error aquí. También puede cortar de lado: la época que tiene tu teléfono y la época que tiene Yomi no tienen por qué ser la misma, así que los dos dispositivos pueden leer cada uno una porción diferente del mismo grupo.

• Instalar Yomi no rota nada por sí mismo, así que "antes de instalar Yomi" es el límite equivocado. Yomi solo resuelve una clave de grupo existente; nunca registra (crea) una, porque crearla rota el secreto compartido del grupo para cada miembro y deja varados todos los mensajes cifrados con la anterior. Así que una instalación nueva toma la clave actual y lee hasta la última rotación — que puede ser anterior a la instalación por meses. El límite es la última reconfiguración de clave, no tu fecha de instalación. Y una vez que Yomi ha visto una época, conserva esa clave, así que una rotación posterior a la instalación le permite leer ambos lados. Si un grupo vuelve indescifrable hasta hoy, eso no es esta limitación — por favor, repórtalo.

• Los medios 1:1 usan el llavero E2EE a nivel de cuenta, que un dispositivo secundario posee por completo (LINE lo sincroniza durante el emparejamiento) — Yomi puede descifrar imágenes/archivos 1:1 que puede ver.

• El relleno del historial 1:1 es la única limitación real. LINE no entrega a un dispositivo secundario el historial pasado de mensajes 1:1 como hace con los grupos. Los mensajes recibidos mientras Yomi está conectado se descifran con normalidad; desplazarse profundamente en el historial 1:1 anterior al emparejamiento puede volver vacío. Esto es una restricción del lado del servidor de LINE, no un error aquí.

Cuando el descifrado falla de verdad, Yomi devuelve un error explícito missing_decrypt_material — nunca una tarjeta falsa o un marcador de posición. El silencio es honesto; un resultado fabricado no lo es.

Desarrollo

Para los colaboradores que trabajan en el código fuente de Yomi (requiere bun o Node.js 24+ — .nvmrc fija el mismo 24 que instala CI, así que nvm use en este directorio lo selecciona; ten en cuenta que nvm no lee engines, por eso los dos se indican por separado y están protegidos por una prueba):

bun install                 # install dependencies (or npm install)
bun run.mjs                 # run the stdio MCP server
bun run.mjs login           # run the login flow in a terminal
npm run build               # tsc --noEmit — type-check only (Yomi ships & runs from src/)
npm test                    # bun test

La compilación solo verifica tipos y compila; este repositorio no se comunica con servidores LINE en vivo como parte de su propia compilación. Conectar un cliente MCP y llamar a login es lo que realmente inicia una sesión.

src/
  line/     LINE protocol core: TCompact/Thrift codec, E2EE (Letter-Sealing,
            group keys, media), Talk/Auth/Sync service clients, session state,
            passwordless login flow.
  auth/     Credential store (macOS Keychain, JSON-file fallback off-darwin).
  search/   Local cross-conversation index (SQLite + FTS5) and the offline
            embedding pipeline (transformers.js).
  mcp/      The stdio server: tool schemas, handlers, the privacy-policy loader,
            and the experimental MCP Apps login view (mcp/ui/).
  util/     [TAG]-prefixed logger (stderr only — stdout is the MCP JSON-RPC stream).

Todo lo que Yomi escribe para humanos va a stderr; stdout está reservado para el flujo JSON-RPC de MCP. Un console.log suelto corrompe el protocolo: no añadas uno en ninguna ruta a la que el servidor pueda llegar.

Privacidad

Por defecto, Yomi indexa todas tus conversaciones en el índice de búsqueda local, en el dispositivo, para que un agente pueda buscar en ellas: un valor predeterminado que lo captura todo, con opción de exclusión por chat. Nunca se sube nada; los únicos datos que salen de tu dispositivo son los que el propio agente muestra en sus respuestas. (La única llamada de red no relacionada con LINE que Yomi realiza es la descarga única del modelo de incrustación desde HuggingFace en la primera búsqueda: pesos del modelo entran, ningún contenido de mensaje sale; ver Búsqueda.) PRIVACY.md es la política canónica, y Yomi muestra ese mismo texto al agente al conectarse (y mediante get_scope_policy) para que pueda revelar el valor predeterminado antes de cualquier lectura masiva.

Descargo de responsabilidad

Yomi es un proyecto personal independiente y no oficial, creado para aprender y para acceder a la propia cuenta de LINE. No está afiliado, autorizado ni respaldado por LINE Corporation. "LINE" es una marca comercial de su respectivo propietario.

El uso de Yomi puede violar los Términos de Servicio de LINE, y operar un cliente adicional en una cuenta puede resultar en limitación de velocidad o suspensión de esa cuenta. Yomi está pensado para acceder a tu propia cuenta y datos. Eres el único responsable de cómo lo uses. El software se proporciona "tal cual", sin garantía de ningún tipo; ver LICENSE.

Agradecimientos

La implementación del protocolo LINE de Yomi se escribió con referencia a tres proyectos de código abierto, cuyos diseños de campos, ordenamiento de fragmentos E2EE, formas de solicitud y definiciones de Thrift informaron esta implementación independiente:

• evex-dev/linejs (MIT) — formas de solicitud y el diseño de la carga útil E2EE de Letter-Sealing.

• DeachSword/CHRLINE (BSD-3-Clause) — diseños de campos de protocolo y el flujo de inicio de sesión sin contraseña.

• er1ce/LINE-Protocol (Apache-2.0) — definiciones de enumeraciones de Thrift (ContentType, MessageRelationType, ServiceCode).

Sus avisos de copyright y textos de licencia completos se reproducen en NOTICE, como exigen sus licencias.

Licencia

MIT