LINE Local MCP

繁體中文 · English

Beta / macOS only / unofficial project. This project is not affiliated with, endorsed by, or sponsored by LY Corporation or LINE. It accesses private, undocumented local storage that may change without notice. This public build does not obtain, extract, derive, or document how to obtain LINE database keys.

繁體中文

LINE Local MCP 是一個唯讀的 Model Context Protocol (MCP) server，讓支援 MCP 的 AI 可以快速搜尋使用者自己 Mac 上的 LINE Desktop 對話紀錄，包括自己傳出與對方傳入的訊息。

它不需要 LINE 官方帳號、不需要把親友拉進群組，也不會逐一點開聊天室。它只讀取 LINE Desktop 已同步到本機的資料庫快照，不會發訊息、修改未讀狀態或寫回 LINE。

專案起源

這個專案源自一個很日常的需求：希望每天的 AI brief 能涵蓋 LINE 裡真正需要回覆的工作與私人訊息，但又不想為了自動化申請 LINE 官方帳號、建立額外群組，或讓程式慢慢點開每一個聊天室。

最初評估過 GUI 自動化，但大量對話會很慢，也可能影響畫面與未讀狀態；只讀取通知則又只能看到對方說了什麼，缺少自己回覆的上下文。最後採用本機唯讀資料庫快照，讓 AI 能在幾秒內讀取完整雙向上下文，同時把「讀取」與「回覆／發送」明確分開。

能做什麼

提供 5 個唯讀工具，AI 可依使用者指令自行組合：

LINE 官方／商業帳號預設排除；可由呼叫端明確要求納入。密碼、驗證碼及 URL 中常見的 token 參數預設遮蔽。

使用前提

• macOS（目前唯一支援的平台）。

• LINE Desktop 已安裝在 /Applications/LINE.app 並登入。

• Python 3.11 以上。

• 啟動 MCP 的 Terminal 或 AI client 具備 macOS「完整磁碟存取」。

• 使用者已自行取得且有權使用 LINE 本機資料庫金鑰。本公開版不提供取得金鑰的方法。

• 只用於使用者本人有權存取的 LINE 帳號與裝置。

• 使用雲端 AI 時，Mac 必須保持醒著，LINE 必須已同步；Mac 睡眠時不會產生更新資料。

目前已在 Apple Silicon Mac、LINE Desktop 9.13.0、macOS 26.5.1 上完成端到端驗證。其他 LINE／macOS 版本可能可用，但尚未保證。

安裝

1. 下載或 clone 此 repo。

2. 在 Finder 雙擊 install.command；若 macOS 阻擋，請按右鍵選擇「打開」。

3. 安裝程式會建立此資料夾專用的 .venv，安裝相依套件並執行 readiness check。

4. 若尚未把資料庫金鑰存入 Keychain，安裝程式會停止並提示你手動執行：

.venv/bin/line-local-mcp --store-key

--store-key 只會從隱藏輸入讀取你自行提供的 64 位十六進位金鑰，並存入 macOS Keychain；它不會取得、擷取或推導金鑰。

可以隨時檢查：

.venv/bin/line-local-mcp --doctor

輸出只包含連線狀態、對話／訊息筆數與同步時間，不會列出訊息內容。

接到 AI client

安裝後的固定指令是：

/完整路徑/line-local-mcp/.venv/bin/line-local-mcp

通用 STDIO MCP 設定：

{
  "mcpServers": {
    "line": {
      "command": "/完整路徑/line-local-mcp/.venv/bin/line-local-mcp"
    }
  }
}

Codex CLI：

codex mcp add line -- /完整路徑/line-local-mcp/.venv/bin/line-local-mcp

依 OpenAI MCP 文件，新增後重啟桌面 app／client，再用 /mcp 確認 line 已連線。

可以這樣要求 AI：

• 「讀我過去 24 小時的 LINE，排除官方帳號，整理待回覆事項。」

• 「搜尋最近一週提到『發票』的 LINE 訊息，依聊天室整理。」

雲端 AI 與 tunnel

本機 HTTP 模式只監聽 loopback：

.venv/bin/line-local-mcp --transport streamable-http --port 8765

端點為 http://127.0.0.1:8765/mcp。它沒有內建公開網路驗證，請勿直接 port-forward 或暴露到公網。

OpenAI 產品可使用官方 Secure MCP Tunnel，透過 outbound HTTPS 連接本機 STDIO 或 loopback HTTP server。無論使用哪種 tunnel，Mac、LINE 和 tunnel client 都必須保持運作。

安全性與隱私

請在使用前理解以下邊界：

• **唯讀保證範圍：**所有 MCP tools 都標記為 read-only；程式只開啟複製到暫存目錄的資料庫快照，不提供傳送、刪除、已讀或修改訊息的工具。

• **金鑰取得不在本專案範圍內：**本公開版不提供取得、擷取、推導或教學 LINE database key 的功能。

• **金鑰保存：**使用者自行提供的金鑰會存入 macOS Keychain 的 line-cua-mcp-dbkey；MCP 回傳值、日誌及 repo 都不包含金鑰。

• **訊息會進入 AI context：**MCP 本身在本機讀取資料，但被工具回傳的訊息會送到呼叫它的 AI client／模型。請先確認該服務的隱私、保存與訓練政策。

• **遮蔽不是 DLP：**內建遮蔽只涵蓋常見密碼標籤、驗證碼和敏感 URL query keys，不保證辨識所有個資、金鑰、銀行資料或公司機密。

• **完整磁碟存取：**macOS 權限會讓啟動程式具備廣泛的本機讀取能力。只授權你信任的 Terminal／AI client，並檢查其自身安全性。

• **私有格式：**LINE 更新可能改變資料庫格式、路徑或加密方式。更新後先執行 --doctor。

更多威脅模型、回報方式與維護政策請見 SECURITY.md。

設定

若 LINE 更新後金鑰失效：

.venv/bin/line-local-mcp --store-key

疑難排解

找不到 LINE database

• 確認 LINE Desktop 已登入並完成同步。

• 對 Terminal 或 AI client 開啟「系統設定 → 隱私權與安全性 → 完整磁碟存取」，再完整重啟該程式。

Keychain key unavailable / file is not a database

• 確認你已自行取得有權使用的資料庫金鑰。

• 執行 .venv/bin/line-local-mcp --store-key，重新存入 Keychain。

AI 找不到新 MCP

• 檢查設定中的 command 是絕對路徑。

• 執行 .venv/bin/line-local-mcp --doctor。

• 重啟 AI client；Codex 可用 codex mcp list 檢查。

訊息不是最新的

• MCP 只讀取 LINE Desktop 已同步到 Mac 的資料；喚醒 Mac、開啟 LINE 並等待同步。

開發與測試

python3 -m venv .venv
.venv/bin/pip install -e '.[test]'
.venv/bin/pytest

測試使用合成資料，不需要真實 LINE 對話或金鑰。貢獻方式請見 CONTRIBUTING.md。

參與開源專案

• 提交問題或功能建議：GitHub Issues

• 貢獻程式碼：CONTRIBUTING.md

• 支援範圍：SUPPORT.md

• 安全通報：SECURITY.md

• 專案治理：GOVERNANCE.md

• 版本變更：CHANGELOG.md

• 社群行為準則：CODE_OF_CONDUCT.md

限制與免責

• Beta：目前只對一組 macOS／LINE Desktop 環境完成真實端到端驗證。

• 只讀本機已同步的文字與部分非文字預覽；不下載附件內容。

• LINE 的私有格式或服務條款可能變更；使用者須自行確認所在地法律、帳號權限與 LINE 條款。

• 僅供使用者存取本人有權使用的帳號與資料，請勿用於未經授權的監控、存取、金鑰取得或金鑰使用。

• LINE 及其商標屬其各自權利人。本專案與 LY Corporation／LINE 無關，未獲其背書。

Related MCP server: line-cua-mcp

English

LINE Local MCP is a read-only Model Context Protocol server for searching both sides of a user's own LINE Desktop history on macOS. It reads disposable snapshots of the local encrypted database; it does not click chats, change unread state, send messages, or require a LINE Official Account.

Why this project exists

The project began with a practical daily-brief problem: relevant work and personal follow-ups often live in LINE, but creating an Official Account, adding family or friends to bot groups, or clicking through every chat is intrusive and slow. Notifications only show the other person's messages and omit the user's replies. A local read-only snapshot provides fast, bidirectional context while keeping reading strictly separate from sending.

Requirements

• macOS and LINE Desktop installed at /Applications/LINE.app, signed in and synchronized.

• Python 3.11+.

• Full Disk Access for the Terminal or AI client that launches the MCP server.

• A LINE local database key the user has already obtained and is authorized to use. This public build does not obtain, extract, derive, or document how to obtain keys.

• Use only with a LINE account and Mac the user is authorized to access.

The current end-to-end test baseline is Apple Silicon, LINE Desktop 9.13.0, and macOS 26.5.1. Other versions are not yet guaranteed.

Quick start

1. Clone or download this repository.

2. Double-click install.command (right-click → Open if macOS blocks it).

3. If needed, store your own authorized database key with .venv/bin/line-local-mcp --store-key.

4. Add the absolute .venv/bin/line-local-mcp command to a local STDIO MCP client.

5. Restart the client and verify the line server.

Codex example:

codex mcp add line -- /absolute/path/line-local-mcp/.venv/bin/line-local-mcp

Read the Traditional Chinese sections above for the complete setup, security model, cloud tunnel guidance, troubleshooting, and limitations. Security reports should follow SECURITY.md.

Open source community

Issues and contributions are welcome. See CONTRIBUTING.md, SUPPORT.md, GOVERNANCE.md, CODE_OF_CONDUCT.md, and CHANGELOG.md.

License

MIT. See LICENSE.