Yomi (読み) — 개인용 LINE MCP 서버

Yomi는 개인 계정을 위한 오픈소스 LINE MCP 서버입니다. 브라우저, 봇 계정, LINE 공식 클라이언트 없이도 Claude나 로컬 AI 에이전트에서 모든 대화를 읽고, 답장하고, 이미지를 보내고, 검색할 수 있습니다.

이 이름은 여러 가지로 읽힙니다. 読み(요미) — 읽기: 메시지를 파싱하는 것만이 아니라, 당신이 하듯 상황을 읽는 것. 詠み(요미) — 읊다: 조용히 읽기만 하지 않고, 당신에게 다시 읽어 들려줍니다. 그리고 黄泉(요미) — 닿을 수 없는 저승; 黄泉帰り(요미가에리), "요미에서 돌아오다"의 바로 그 요미. 두 세계 사이를 오가는 전령처럼, Yomi는 봉인과 침묵을 통과하여 대화 속 깊은 곳에서 아직 읽을 수 있는 메시지를 빛으로 다시 가져옵니다. 이미 잃어버린 역사를 소환하지 않으며, 사라지지 않은 것을 다시 볼 수 있게 도와줍니다.

LINE의 공식 Bot MCP 서버가 Messaging API를 통해 AI 에이전트를 LINE 공식 계정에 연결하는 것과 달리, Yomi는 보조 기기로써 기존 개인 LINE 계정과 대화에 연결됩니다.

Yomi는 LINE의 TCompact-over-HTTPS 프로토콜을 직접 구사하고, Letter-Sealing(E2EE) 메시지와 미디어를 복호화하며, 그 결과를 작은 stdio MCP 서버를 통해 모든 AI 에이전트에 노출합니다. Claude Desktop(또는 모든 MCP 클라이언트)에서 이를 가리키면 에이전트가 당신처럼 LINE을 따라잡을 수 있습니다 — 읽기, 답장, 이미지 보내기, 멘션, 전체 기록 로컬 검색 — 그리고 get_insight로 상황을 읽을 수 있습니다: 어떤 대화가 당신의 답장을 기다리고 있는지, 누가 당신의 세계를 연결하는지, 무엇이 기한을 넘겼는지.

공식 API도, 봇 계정도, 웹훅도 없습니다. Yomi는 당신 계정의 보조 기기로 로그인합니다.

가이드: LINE MCP 서버란 무엇인가요? · LINE MCP 是什麼？Yomi、官方 Bot 與桌面自動化的差異.

비공식. Yomi는 LINE과 제휴하거나 보증하지 않는 독립적인 개인 프로젝트입니다. 이를 사용하면 LINE의 서비스 약관에 위배될 수 있으며, 계정에 추가 클라이언트를 실행하면 속도 제한이나 정지의 위험이 있습니다. 자신의 계정을 읽기 위한 용도입니다. 사용에 따른 책임은 본인에게 있습니다. 면책 조항을 참조하세요.

시작하기

네이티브 데스크톱 미리보기

Yomi Desktop은 LINE 받은 편지함과 로컬 에이전트 작업 공간을 하나의 네이티브 앱에 담습니다. 자체 런타임을 번들로 포함하므로 사용자는 Node를 설치하거나, 터미널을 열거나, 이 저장소를 클론하거나, YOMI_RUN_MJS를 구성할 필요가 없습니다. 네이티브 데스크톱은 아래 설명된 Claude Desktop MCPB 확장과는 별개입니다.

macOS 패키지는 실제 다운로드 앱 경로로 테스트되었습니다: 격리된 DMG, /Applications 설치, Gatekeeper 평가, 첫 실행, 번들 런타임 메시지 새로고침, 터미널 없는 LINE 로그인 양식. Windows 설치 프로그램에는 동일한 인앱 전화/PIN 로그인 흐름이 포함되어 있으며 릴리스 전에 네이티브 Windows 러너에서 테스트됩니다.

데스크톱 빌드는 실험적이며 비공식입니다. LINE 변경으로 인해 작동이 중단될 수 있으며, 추가 클라이언트를 실행하면 계정이 위험에 처할 수 있습니다. 테스트 계정을 사용하고 최신 백업을 유지하세요. 미리보기 설치 프로그램은 플랫폼 서명이 가능해진 후에만 GitHub 사전 릴리스로 게시됩니다.

데스크톱 릴리스 프로세스, 코드 서명 정책, 개인정보 보호정책을 참조하세요.

MCP 서버 및 데스크톱 확장

Node.js와 LINE 계정이 필요합니다. Yomi는 npx를 통해 로컬에서 실행됩니다. 이 저장소를 클론하거나, Bun을 설치하거나, 빌드할 필요가 없습니다. 먼저 node --version을 실행하고, 명령이 없거나 버전이 지원되지 않으면 현재 LTS를 설치하세요.

Yomi의 로컬 검색 인덱스는 Node 내장 node:sqlite를 사용하므로 v22.13 이상이 필요합니다 — 단, v23.0–v23.3은 제외됩니다. 이 버전들은 v22.13보다 최신이지만 해당 모듈이 아직 없습니다 (22.13.0과 23.4.0에서 모두 플래그가 해제되었습니다). 현재 LTS는 모두 괜찮습니다. 이것은 package.json의 engines.node입니다. Yomi의 나머지 기능은 이전 Node에서도 실행되지만, 검색, 범위, 캡처는 그렇지 않습니다.

⚠️ Yomi는 사용자 자신의 머신에서 실행하는 클라이언트가 필요합니다. 클라우드 전용 도구(ChatGPT, Claude.ai 웹)는 Yomi를 실행할 수 없습니다. Claude Desktop 또는 Claude Code에서 Yomi를 구성하면 채팅과 Cowork 모두에서 작동합니다. Desktop은 사용자 머신에서 Yomi를 시작하고 Cowork의 로컬 세션이 이를 로드하기 때문입니다. Cowork에게 Yomi를 설치하라고 요청하지 마세요: Cowork의 셸은 사용자 머신이 아닌 일회용 VM 내부에서 실행되므로, 거기에 설치된 것은 세션이 끝나면 사라집니다. 아래 단계를 직접, 자신의 터미널에서 따르세요.

실제로 사용하는 클라이언트를 선택하고 해당 섹션만 따르세요. Claude Code와 Claude Desktop은 별도의 MCP 설정을 가지며, 하나를 구성해도 다른 하나가 구성되지 않습니다.

가장 쉬운 방법이며, 명령줄이 전혀 필요 없는 유일한 방법입니다. Claude Desktop에는 자체 Node 런타임이 포함되어 있으므로 다른 것을 설치할 필요가 없습니다.

1. 최신 릴리스에서 사용자 머신용 번들을 다운로드하세요:

   머신	파일
   Windows (Intel/AMD)	yomi-win32-x64.mcpb
   Mac (Apple Silicon)	yomi-darwin-arm64.mcpb
   Linux (x64)	yomi-linux-x64.mcpb

2. Claude Desktop에서 설정 → 확장 프로그램을 열고, 다운로드한 파일을 해당 페이지로 드래그하세요(또는 파일을 더블클릭하세요).

3. 요청하는 내용을 확인하고 설치를 클릭하세요.

4. 대화를 시작하고 *"LINE에 로그인"*이라고 말하세요. Yomi가 양식을 표시하고, 전화번호를 입력하면 휴대폰에서 확인합니다. 어떤 시점에도 터미널이 필요 없습니다.

이 방법은 구성 파일을 완전히 건너뛰므로 아래 설명된 Windows MSIX 버그도 피할 수 있습니다.

Cowork 사용자 참고: Cowork에게 Yomi를 설치하도록 요청하지 마세요. Cowork의 셸은 사용자 머신이 아닌 일회용 VM 내부에서 실행되며, 실제 터미널에 입력하지 않습니다. 위의 세 번의 클릭으로 번들을 직접 설치하세요. 설치되면 Cowork의 로컬 세션에서 다른 도구처럼 Yomi를 사용할 수 있습니다.

1. npx의 전체 경로를 찾으세요:

macOS / Linux: which npx
Windows:       where npx

2. Claude Desktop 구성 파일을 여세요:

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

⚠️ Windows: 문서화된 경로가 Claude가 실제로 읽는 경로가 아닐 수 있습니다. Claude Desktop은 MSIX 패키지로 제공되며, 파일 시스템이 가상화되어 있습니다. 앱은 다음 위치에서 구성을 읽습니다:

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

반면 설정 → 개발자 → 구성 편집은 가상화되지 않은 %APPDATA%\Claude\ 파일을 엽니다. 이 둘은 동기화되지 않는 서로 다른 파일이므로, 문서화된 경로에 작성된 올바른 Yomi 구성은 조용히 무시됩니다 — 오류도, 로그도 없이 Yomi는 그저 나타나지 않습니다. 이것은 claude-code#26073로, 아직 열려 있습니다. 다시 시작한 후에도 Yomi가 나타나지 않으면 위의 LocalCache 경로에도 동일한 구성을 작성하세요. (Claude Code 또는 MSIX 외부에 설치된 Desktop에는 해당되지 않습니다.)

3. mcpServers 아래에 Yomi를 추가하고, 예시 command를 1단계에서 출력된 전체 경로로 바꾸세요. Windows에서는 JSON에서 경로의 각 \를 \\로 작성해야 합니다:

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

예를 들어 Windows 경로는 "C:\\Program Files\\nodejs\\npx.cmd"처럼 보일 수 있습니다. 두 예시를 맹목적으로 복사하지 말고 자신의 머신에서 보고된 경로를 사용하세요.

⚠️ 여기에 지정한 npx가 Yomi를 실행할 Node를 결정하지 않습니다. macOS와 Linux에서 npx는 #!/usr/bin/env node로 시작하는 스크립트이므로, 방금 가리킨 npx 옆에 설치된 Node가 아니라 Claude Desktop의 PATH에서 가장 먼저 오는 node로 실행됩니다. Desktop은 데스크톱 세션에서 PATH를 상속받는데, 이는 종종 터미널의 것과 다르며, 버전 관리자(nvm, fnm, asdf, volta 등)는 자신의 node를 다른 모든 것보다 앞에 둡니다. 따라서 which npx가 완벽하게 최신 설치를 보고해도 Yomi는 여전히 이전 Node에서 시작될 수 있습니다.

증상은 구체적입니다: 로그인, 읽기, 보내기는 모두 작동하지만 검색, 범위, 캡처가 실패하고 로그에 No such built-in module: node:sqlite라고 표시됩니다. Yomi는 해당 오류에서 실제로 사용된 런타임을 출력합니다 — 추측하지 말고 읽어보세요.

해결책은 서버에 첫 번째 항목이 지원되는 node를 보유한 PATH를 제공하는 것입니다:

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

구분자: macOS/Linux에서는 :, Windows에서는 ;. 그 뒤에 사용 가능한 기본 경로(/usr/local/bin:/usr/bin:/bin 또는 플랫폼에 해당하는 것)를 유지하세요 — 이는 서버의 PATH에 추가하는 것이 아니라 대체하는 것이며, npx는 일반 도구가 필요합니다.

command에 절대 경로 node를 지정하는 것은 아무리 그럴듯해 보여도 작동하지 않습니다: npx는 패키지의 자체 bin을 자식 프로세스로 생성하고 다시 PATH에서 node를 확인하므로, command는 누가 npx를 실행하는지만 결정할 뿐 누가 Yomi를 실행하는지는 결정하지 않습니다. 실제로 서버에 도달하는 것은 PATH를 설정하는 것입니다.

AI 에이전트로 구성하시나요? MCP 구성은 이제 손으로 작성하기보다 대부분 에이전트가 작성하므로, 위 단계는 자신의 머신을 읽는 사람을 위해 설명된 것입니다. 에이전트는 자리 표시자를 출력하는 대신 값을 확인해야 하며, 이 설정에는 명확히 언급할 가치가 있는 함정이 하나 있습니다: command에 npx를 지정하는 것은 런타임을 고정하지 않습니다. 절차:

1. Yomi의 인덱스가 실제로 필요로 하는 모듈을 가진 Node를 찾으세요 — 버전 번호로 추론하지 마세요:

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

   오류가 발생하면 해당 Node는 검색/범위/캡처에 사용할 수 없습니다. 다른 설치(which -a node, nvm ls, fnm list, …)를 시도하여 통과하는 것을 찾을 때까지 계속하세요. 그 후에만 계속 진행하세요.

2. 위 JSON에 따라 해당 Node의 디렉터리를 env.PATH에 쓰고, 그 뒤에 기본 PATH를 유지하세요. 대상 머신에서 디렉터리를 확인하세요(1단계 경로의 dirname). 이 README의 예시를 복사하지 마세요 — Apple Silicon Homebrew 경로이며 거의 모든 곳에서 틀립니다.

   대신 command에 절대 경로 node를 넣지 마세요. 더 강력한 수정처럼 보이지만 그렇지 않습니다: npx는 패키지의 bin을 자식 프로세스로 실행하고 그 자식에 대해 PATH에서 node를 다시 해석하므로, command는 누가 npx를 실행할지만 결정합니다. 이는 추측이 아니라 측정된 결과입니다 — PATH의 첫 번째가 Node 20일 때, command 고정으로도 서버에 Node 20이 전달되었습니다.

   command -v는 실제 바이너리 대신 래퍼를 반환할 수도 있습니다 — 힙 셰임, 로컬 우선 npx 래퍼, 버전 관리자 스텁이 모두 흔하며, 일부는 클라이언트의 작업 디렉터리에 따라 다르게 동작합니다. "진짜" 바이너리를 추론하려 하지 마세요. 3단계가 해결합니다.

3. 인덱스에 접근하는 도구로 검증하세요. yomi version은 검증이 아닙니다 — SQLite를 열지 않고 문자열을 출력하므로 검색을 실행할 수 없는 Node에서도 성공합니다. get_scope_policy를 호출하세요: SQLite가 필요하며 LINE 로그인이 필요 없습니다. 정책 텍스트를 반환하면 런타임이 올바른 것입니다. 실패하면 오류가 실제로 실행된 Node와 필요한 것을 알려줍니다.

4. Claude Desktop을 완전히 종료하고 다시 엽니다. 다른 것보다 먼저 Settings → Developer에서 Yomi가 로드되었는지 확인하세요: Yomi가 목록에 없으면 Claude가 구성을 읽지 않은 것입니다 — Windows에서는 2단계의 MSIX 경고를 참조하세요. 목록에 표시되면 도구는 채팅과 Cowork의 로컬 세션 모두에서 사용할 수 있습니다.

이 설정에 Claude Code를 설치할 필요는 없습니다.

claude mcp add yomi -- npx @rikaidev/yomi

새 claude 세션을 시작하세요. Yomi 도구가 자동으로 나타나야 합니다. 이 명령은 Claude Code만 구성합니다. Claude Desktop은 구성하지 않습니다.

이 형식은 런타임을 PATH에 맡깁니다. claude 세션이 해석하는 node가 지원되는 버전이라면 괜찮습니다 — Claude Desktop과 달리 볼 수 있는 것과 같은 PATH입니다. node -e 'require("node:sqlite")'로 확인하세요. 오류가 발생하거나 PATH에 의존하고 싶지 않다면 Node를 명시적으로 지정하세요:

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

어느 쪽이든 yomi version 대신 get_scope_policy로 검증하세요: 버전 명령은 SQLite를 열지 않고 문자열을 출력하므로 검색을 실행할 수 없는 Node에서도 통과합니다.

이 저장소의 클론 안에서 Claude Code를 실행 중인가요? 스펙을 @rikaidev/yomi@latest로 지정하세요. 태그가 없으면 npx가 로컬 bin을 먼저 찾는데, 이 저장소의 package.json은 "bin": {"yomi": ...}을 선언하지만 node_modules/.bin에 링크하지 않으므로 npx가 설치를 건너뛰고 sh: yomi: command not found로 실패합니다. 명시적 태그를 사용하면 게시된 패키지를 가져옵니다. Yomi 자체의 작업 복사본에만 영향을 줍니다. 다른 곳에서는 태그 없는 형식이 괜찮습니다.

이 표준 구성은 대부분의 MCP 클라이언트에서 작동합니다:

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

Cursor Settings → MCP → Add new MCP Server → 이름을 yomi로 지정, 명령 유형, 값: npx @rikaidev/yomi

또는 프로젝트 루트의 .cursor/mcp.json에 추가하세요.

.vscode/mcp.json에 추가:

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

~/.config/opencode/opencode.json에 추가:

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

codex mcp add yomi npx @rikaidev/yomi

또는 ~/.codex/config.toml에 추가:

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

cline_mcp_settings.json에 추가:

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

~/.codeium/windsurf/mcp_config.json에 추가 — 표준 구성과 동일한 JSON입니다.

amp mcp add yomi -- npx @rikaidev/yomi

Advanced settings → Extensions → Add custom extension → 이름 yomi, 유형 STDIO, 명령: npx @rikaidev/yomi

grok mcp add yomi -- npx @rikaidev/yomi

첫 로그인

연결되면 에이전트에게 말하세요:

"LINE에 로그인해 줘 — 내 번호는 +8869XXXXXXXX야."

휴대폰에서 기기를 승인하고(Logging in 참조), 다음을 말하세요:

"읽지 않은 LINE을 요약하고 누가 답장을 기다리고 있는지 알려줘."

Related MCP server: line-desktop-mcp

할 수 있는 일

Yomi는 MCP를 통해 20개의 도구를 제공합니다(이름을 붙일 가치가 있는 것들; 표 참조). 큰 읽기 결과는 토큰 효율적인 TOON을 사용하고, 작은 상태 및 쓰기 결과는 간결한 JSON을 사용합니다. 오류는 일반 텍스트로 유지되며 미디어는 네이티브 MCP 이미지/오디오/리소스 콘텐츠를 사용합니다. 아래 "정직한 오류"는 문제를 명명하는 명시적 실패(예: missing_decrypt_material)를 의미합니다 — Yomi는 대체, 자리 표시자, 가짜 성공을 절대 만들지 않습니다.

읽기

인사이트 (메시지뿐 아니라 상황 읽기)

쓰기 (실제로 전송 — 초안 아님)

검색 (로컬, 대화 간 — LINE에는 그러한 기본 기능이 없음)

범위 및 개인정보 보호(모든 작업은 오프라인으로 수행되며 LINE 세션 불필요)

세션

로그인

전제 조건: 기본 휴대폰에서 設定 › 我的帳號 › 允許自其他裝置登入 (설정 › 내 계정 › 다른 기기에서 로그인 허용)을 활성화하세요. 이 설정이 없으면 LINE은 이 기기에 로그인 프롬프트를 제공하지 않습니다. 이는 첫 로그인이 멈춘 것처럼 보이는 가장 흔한 원인입니다.

⚠️ 데스크톱 세션 1개 제한: LINE은 계정당 데스크톱 클라이언트 세션을 하나만 허용합니다. Yomi는 데스크톱 보조 기기(DESKTOPMAC)로 연결되므로, Yomi에 로그인하면 공식 LINE 데스크톱 앱이 로그아웃됩니다(그리고 LINE 데스크톱에 다시 로그인하면 Yomi의 세션이 무효화됩니다). Yomi와 공식 LINE 데스크톱 클라이언트를 동시에 사용할 수 없습니다.

에이전트에게 E.164 형식의 전화번호만 제공하면 됩니다. 도구를 호출할 때 에이전트가 지역을 직접 제공합니다(예: +886 번호의 경우 TW).

Yomi는 LINE의 비밀번호 없는(보조 기기) 흐름을 구동합니다. 로그인이 표시되는 방식은 MCP 클라이언트에 따라 다릅니다:

• MCP elicitation 기능이 있는 클라이언트 — login은 전화번호/지역을 입력하라는 프롬프트를 표시하고, 대화 상자에 PIN을 표시하며, 완료될 때까지 차단합니다. 한 번의 호출로 PIN이 모델을 통해 전달되지 않습니다. 전화번호가 대화 기록에 입력되지 않습니다.

• 이 기능이 없는 클라이언트(예: 현재 Claude Desktop) — 두 번의 호출. login(전화번호 + 지역 포함)은 결과에 PIN을 반환합니다. 기본 휴대폰의 LINE에 PIN을 입력하고 기기를 승인한 다음 login_complete을 호출하면 휴대폰이 확인할 때까지 차단됩니다. 에이전트는 login_complete을 즉시 호출해야 합니다. 대기 작업을 수행하므로 보고할 내용이 없습니다.

• 터미널에서 — npx @rikaidev/yomi login은 PIN을 포함한 전체 흐름을 stdout에서 실행합니다. 항상 대체 수단으로 사용할 수 있습니다.

중요한 마감은 LINE의 것입니다: PIN이 표시된 시점부터 입력하고 기기를 승인하는 데 약 3분이 주어집니다. Yomi 자체 클라이언트는 그 이후에도 수 분 동안 계속 수신하므로 느린 휴대폰이 문제가 되는 경우는 없습니다. LINE의 3분 코드 유효 기간만이 유일한 제한입니다.

로그인하면 로그인 인증서를 포함한 세션이 유지되며(아래 참조), 이후 로그인은 PIN을 완전히 건너뜁니다.

대화형 보기를 렌더링하는 클라이언트를 위한 실험적인 MCP Apps UI (ui://yomi/login 카드)도 있습니다. 사양에 맞게 구현되었으며 MCP Inspector에서 렌더링되지만, 일부 호스트는 보기 핸드셰이크를 완료하지 않고 리소스를 가져오므로 표시 전용이며 중요한 경로에 포함되지 않습니다 — 위의 흐름은 항상 작동합니다.

세션 및 자격 증명

Yomi는 자체 로그인을 관리합니다. 시작 시 resumeSession()을 한 번 호출하여 macOS 키체인(서비스 dev.rikai.yomi.credentials, 계정 line)에서 LINE 세션을 읽고 필요한 경우 토큰을 자동으로 갱신합니다.

• 자사 자격 증명. 비밀번호 없는 로그인은 인증 토큰, 갱신 토큰, 인증서, MID, E2EE 키페어 자체를 유지한 다음 이를 다시 읽어 기록이 실제로 저장되었는지 확인합니다. 유지할 수 없는 로그인은 다음 재시작 시 조용히 실패하지 않고 로그인 시점에 명확하게 실패합니다.

• 공유 세션. 세션은 표준 dev.rikai.yomi.credentials 키체인 항목(또는 로컬 자격 증명 저장소)에 저장되므로 Yomi MCP와 Yomi Desktop이 정확히 동일한 LINE 로그인 세션을 원활하게 공유할 수 있습니다.

• 플랫폼 참고 사항. macOS에서는 세션이 로그인 키체인에 저장됩니다. Linux 및 Windows에서는 Yomi가 현재 로컬 JSON 파일로 대체합니다. 기능은 하지만 OS 비밀 저장소보다 보호 수준이 낮고 macOS 경로보다 덜 검증되었습니다. 네이티브 보안 저장소 백엔드(libsecret / DPAPI)가 계획되어 있습니다. 그때까지는 비-macOS 설치를 그에 맞게 취급하세요.

login과 오프라인 범위/검색 도구를 제외한 모든 도구는 세션이 없을 때 정직한 오류를 반환합니다. Yomi는 그 외에는 순수한 쿼리 서버입니다. 폴링하지 않고 백그라운드에서 백필하지 않으며, 각 도구 호출은 필요한 LINE 요청만 정확히 수행하고 collect_messages만 여러 채팅을 한 번에 가져오는 유일한 경로입니다.

검색

LINE에는 대화 간 검색이 없습니다. Yomi는 로컬에 검색 기능을 구축합니다. 인덱스는 저장소의 gitignore된 SQLite 데이터베이스(data/search-index.db)입니다. 어떤 것도 기기를 떠나지 않습니다.

검색은 설계상 하이브리드입니다. 항상 FTS5 키워드 검색(단어 경계가 없는 CJK 하위 문자열도 포함하도록 bigram 전처리된 텍스트에 대한 bm25)을 실행하고, 임베딩이 존재할 때 의미 검색을 실행한 다음 Reciprocal Rank Fusion으로 두 순위 목록을 융합합니다. 순수 의미 검색은 임베딩되지 않은 메시지에 있는 정확한 일치 항목을 조용히 놓치고, 순수 키워드는 의역을 놓칩니다. 둘을 융합하면 정확한 용어와 의미 일치가 함께 표시됩니다. 응답의 mode 필드는 항상 어떤 방법이 기여했는지 보고합니다.

의미 순위는 각 메시지를 자체 벡터로 유지합니다. 실제 인덱싱된 LINE 대화에 대한 테스트에서 겹치는 대화 창을 임베딩하면 중심 메시지가 희석되고 검색 품질이 저하되는 것을 발견했습니다. 따라서 컨텍스트는 순위가 매겨진 후에만 추가됩니다. Yomi는 한 채팅이 상위 결과를 도배하지 못하도록 제한하고 각 우승 메시지의 양쪽에 두 개의 메시지를 확장하여 에이전트가 검색 결과에 의미를 부여한 대화를 볼 수 있게 하면서도 임베딩 자체는 약화시키지 않습니다.

의미 순위는 transformers.js를 통해 Xenova/bge-small-zh-v1.5(BAAI 범용 임베딩, 소형, 중국어 우선이지만 다국어)를 사용합니다. 임베딩 추론은 완전히 프로세스 내 CPU에서 실행됩니다. 메시지 텍스트가 외부로 전송되지 않습니다.

유일한 주의 사항은 일회성 모델 다운로드입니다. 첫 collect_messages 또는 search_messages에서 transformers.js가 **huggingface.co**에서 모델(~90MB)을 가져와 로컬에 캐시합니다. 이후 모든 실행은 완전히 오프라인입니다. 이 첫 번째 가져오기는 모델 가중치에 대한 HuggingFace로의 아웃바운드 HTTPS 요청입니다. IP 주소와 어떤 모델이 다운로드되는지가 전달되지만 메시지 내용이나 LINE 데이터는 포함되지 않습니다. Yomi를 완전히 에어갭 환경에서 사용해야 한다면 첫 검색 전에 transformers.js 캐시를 미리 채우거나 (또는 로컬 모델 디렉터리를 가리키도록) 설정하여 네트워크 호출이 전혀 발생하지 않도록 하세요.

보조 기기의 현실( "이전 메시지를 가져올 수 없다"는 말을 믿기 전에 읽으세요)

Yomi는 계정의 보조 기기로 실행됩니다. 이는 Yomi가 볼 수 있는 범위를 결정합니다:

• Letter Sealing이 없는 그룹 채팅은 LINE 서버에서 평문입니다 — 전체 기록 및 미디어, 제한 없음.

• Letter Sealing이 있는 그룹 채팅은 E2EE이며, 여기서 epoch가 중요합니다. 이러한 그룹은 공유 그룹 키로 암호화되며(멤버십 변경 시 또는 클라이언트가 새 키를 프로비저닝할 때) 회전합니다. LINE은 기기에 현재 그룹 키만 제공합니다. 대체된 키를 가져오는 API는 없습니다. 따라서 보조 기기는 보유한 키의 epoch부터 메시지를 해독합니다. Yomi가 현재 키를 얻기 전의 이전 epoch에서 보낸 메시지는 해독 불가능하게 반환될 수 있습니다. 이전 기록을 읽을 수 있는 그룹에서도 마찬가지입니다. 이는 Letter Sealing의 epoch별 그룹 키에 내재된 특성이며 여기의 버그가 아닙니다. 또한 측면으로도 작용할 수 있습니다. 휴대폰이 보유한 epoch와 Yomi가 보유한 epoch가 같을 필요는 없으므로 두 기기가 동일한 그룹의 서로 다른 조각을 각각 읽을 수 있습니다.

• Yomi 설치 자체는 아무것도 회전시키지 않으므로 "Yomi 설치 전"은 잘못된 경계입니다. Yomi는 기존 그룹 키를 해석만 하며 새 키를 등록(생성)하지 않습니다. 생성은 그룹의 공유 비밀을 모든 멤버에 대해 회전시키고 이전 키로 암호화된 모든 메시지를 읽을 수 없게 만들기 때문입니다. 따라서 새 설치 시 현재 키를 가져와 마지막 회전 시점까지 읽습니다. 이는 설치보다 수 개월 전일 수 있습니다. 경계는 설치 날짜가 아니라 마지막 재키 변경입니다. 그리고 Yomi가 epoch를 보면 해당 키를 유지하므로 설치 후 회전이 발생해도 양쪽을 모두 읽을 수 있습니다. 그룹이 오늘까지 전부 해독 불가능하게 반환된다면 이는 이 제한이 아닙니다. 보고해 주세요.

• 1:1 미디어는 계정 수준 E2EE 키체인을 사용하며, 보조 기기가 완전히 보유합니다 (LINE이 페어링 중에 동기화). Yomi는 볼 수 있는 1:1 이미지/파일을 해독할 수 있습니다.

• **1:1 기록 백필이 유일한 실제 제한입니다.** LINE은 그룹의 경우처럼 보조 기기에 과거 1:1 메시지 기록을 제공하지 않습니다. Yomi가 연결된 동안 수신된 메시지는 정상적으로 해독되지만, 페어링 이전의 1:1 기록을 깊이 스크롤하면 비어 있을 수 있습니다. 이는 LINE 서버 측 제한이며 여기의 버그가 아닙니다.

해독이 실제로 실패하면 Yomi는 가짜 카드나 자리 표시자가 아닌 명시적인 missing_decrypt_material 오류를 반환합니다. 침묵은 정직한 것이고, 조작된 결과는 그렇지 않습니다.

개발

Yomi 소스 코드에 기여하는 개발자를 위한 내용입니다(bun 또는 Node.js 24+ 필요 — .nvmrc는 CI가 설치하는 것과 동일한 24를 고정하므로 이 디렉터리에서 nvm use를 실행하면 해당 버전을 사용합니다. nvm은 engines를 읽지 않으므로 두 항목이 별도로 명시되고 테스트로 보호됩니다):

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

빌드는 타입 검사와 컴파일만 수행합니다. 이 저장소는 자체 빌드의 일부로 실제 LINE 서버와 통신하지 않습니다. MCP 클라이언트를 연결하고 login을 호출하는 것이 실제로 세션을 시작하는 방법입니다.

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).

Yomi가 사람을 위해 작성하는 모든 것은 stderr로 출력됩니다. stdout은 MCP JSON-RPC 스트림 전용입니다. 잘못된 console.log는 프로토콜을 손상시킵니다. 서버가 도달할 수 있는 경로에는 추가하지 마세요.

개인정보 보호

기본적으로 Yomi는 모든 대화를 로컬 온디바이스 검색 인덱스에 색인하여 에이전트가 대화 전체를 검색할 수 있게 합니다 — 기본값은 전체 수집이며, 채팅별로 제외할 수 있습니다. 어떤 데이터도 업로드되지 않습니다. 기기를 떠나는 유일한 데이터는 에이전트가 답변에서 직접 노출하는 내용뿐입니다. (Yomi 자체가 수행하는 유일한 비-LINE 네트워크 호출은 첫 검색 시 HuggingFace에서 임베딩 모델을 일회성으로 다운로드하는 것입니다 — 모델 가중치만 들어오고 메시지 내용은 나가지 않습니다. 검색 참조.) PRIVACY.md가 표준 정책이며, Yomi는 연결 시(그리고 get_scope_policy를 통해) 에이전트에게 동일한 텍스트를 제공하여 대량 읽기 전에 기본값을 공개할 수 있게 합니다.

고지 사항

Yomi는 독립적이고 비공식적인 개인 프로젝트로, 학습과 자신의 LINE 계정 접근을 위해 만들어졌습니다. LINE Corporation과 제휴, 승인, 보증 관계가 없습니다. "LINE"은 해당 소유주의 상표입니다.

Yomi를 실행하면 LINE의 서비스 약관을 위반할 수 있으며, 계정에서 추가 클라이언트를 운영하면 해당 계정의 속도 제한 또는 정지가 발생할 수 있습니다. Yomi는 자신의 계정과 데이터에 접근하기 위한 용도로 제작되었습니다. 사용 방법에 대한 책임은 전적으로 사용자에게 있습니다. 이 소프트웨어는 어떠한 종류의 보증도 없이 "있는 그대로" 제공됩니다 — LICENSE 참조.

감사의 말

Yomi의 LINE 프로토콜 구현은 세 가지 오픈소스 프로젝트를 참고하여 작성되었으며, 해당 프로젝트의 필드 레이아웃, E2EE 청크 순서, 요청 형태, Thrift 정의가 이 독립 구현에 기반이 되었습니다:

• evex-dev/linejs (MIT) — 요청 형태와 Letter-Sealing E2EE 페이로드 레이아웃.

• DeachSword/CHRLINE (BSD-3-Clause) — 프로토콜 필드 레이아웃과 비밀번호 없는 로그인 흐름.

• er1ce/LINE-Protocol (Apache-2.0) — Thrift 열거형 정의(ContentType, MessageRelationType, ServiceCode).

해당 라이선스가 요구하는 대로 저작권 고지와 전체 라이선스 전문이 NOTICE에 재현되어 있습니다.

라이선스

MIT