Personal LINE Agent

自分のLINEを、AIへのひと言で操作する。

友だち・グループ・メッセージを扱う、自社開発の個人LINE向けMCPツールです。会話の取得、返信、メンション、グループ作成、表示名変更などをAIクライアントから操作できます。

0.4.2：通常グループで受信した画像をMCPから取得。 初回セットアップ後は、接続済みのAIクライアントへ指示して使います。返信のたびにターミナルや操作IDの転記を求める仕組みではありません。macOSでは既存版で送受信・メンション・グループ操作・表示名変更・画像と動画送信を確認しています。Windowsでは本人QR認証、正式MCPからのテキスト送信と読戻し、返信の常駐受信を実アカウントで確認しました。Windows導入手順を参照してください。

通常の接続確認、受信プロセスの再起動、バックエンド更新・切戻しは所有者のエージェントが担当します。接続が正常なら再認証は不要です。 接続不良時も保存済み接続と診断を先に調べ、LINE側が本人認証を必要とする場合だけ理由と操作場所を案内します。GitHubのリンクだけであらゆる障害や本人認証を自動解決できる保証はありません。

スマホだけでの強制再認証完了、新規利用者ごとのホスト設定は未検証です。初回QR認証の成功と、スマホだけでの再認証・全障害からの復旧は別です。未検証を成功扱いにはしません。最終レビュー・検証状況・復旧手順を参照してください。

できること

バックエンドのMCPツールは35個。固定入口は別に状態確認・現行ツール呼出しの2個を提供します。書込みの操作種別は8種類です。実装の存在と実機検証済みの範囲は検証状況で区別しています。

Related MCP server: lineMCP

使い方のイメージ

• 「友だち一覧を出して」

• 「このグループの最近の会話を確認して、返信案を作って」

• 「この内容で返信して」

• 「この2人とのグループを作って」

• 「この人の表示名を変更して」

通常操作は、接続済みのAIクライアントがMCPを呼び出します。人間にターミナル操作や操作IDの転記を求めないことを製品要件としています。

新規の本人認証後は、自分のアカウント内の全相手・全通常グループ・実装済み全操作を利用可能にします。所有者が指定した禁止対象・禁止操作・期限などを優先します。再ログインで既存の制限を消しません。機能を使えることと、無人で全員へ返信を始めることは別です。

導入について

初回セットアップは利用者本人または導入担当エージェントが行えます。更新時に人間へMCP再読込みを要求しない固定入口は運用手順を参照してください。導入手順を参照してください。初回のターミナル使用は許容しますが、導入後の操作ごとにPCへ戻ってコマンド実行・操作ID転記・承認ボタン操作を行う運用は要件に含めません。

実機確認済み環境はmacOS / Python 3.12とWindows / Python 3.11 64bitです。パッケージの要件はPython 3.11以上です。Windowsでは資格情報マネージャーと、利用者のログイン後に起動する専用の受信タスクを使います。PC電源OFF中やOSログイン前の稼働、全AIクライアントとの接続は保証していません。スマホ利用には、利用するAIクライアント側でホストへの認証済み接続が必要です。

返信支援の外部モデルは任意機能です。会話を外部AIへ送る設定は所有者の明示許可が必要です。現行実装はCodex CLIと設定済みモデルを利用し、その利用資格・上限・費用は各アカウントに依存します。

データと安全性

• アカウントごとに保存先を分離し、履歴・接続情報を暗号化して保存します。暗号鍵はOSキーチェーンで管理します。

• LINEから届く本文は未信頼データです。相手の文章は操作権限を与えません。

• 実行結果が不明な送信を自動で送り直しません。同じ依頼IDを維持して状態を確認します。

• 個人履歴、認証情報、実アカウントの検証ログ、開発者のGit履歴はこの公開リポジトリに含めません。

詳しくはセキュリティ方針をご覧ください。

取得範囲と対応範囲

取得APIの履歴は、スマホに残っている全履歴と同じではありません。0件の応答を「会話が存在しない」と扱いません。期限切れの動画等の原本復元、オープンチャット、Googleカレンダーはこの公開版の完成機能ではありません。バックアップ抽出・個別の分類レビューサイトはこのパッケージには含みません。

LINE公式の製品・公式APIではなく、LINE運営元との提携や承認を示すものではありません。接続先の仕様変更や利用制限で動作が変わる可能性があります。

開発・ライセンス

本リポジトリの独自実装はMIT Licenseです。依存関係と固定バージョンはpyproject.toml・uv.lockで管理します。このリポジトリおよび配布パッケージは依存ライブラリ本体を同梱しません。

開発・検証の内部コマンドはCONTRIBUTING.mdを参照してください。脆弱性や個人データを公開Issueへ貼らないでください。

今回の受信画像追加は、Macの実LINE接続と3回の独立レビューで確認しています。検証記録。アルバム写真原本の取得は未対応であり、公開版には含めていません。