Focuslog

FocusLog：デスクトップアクティビティ MCP サーバー

デスクトップでのアクティビティを記録し、アクション数／分（APM）を算出して、必要に応じてクリーンで匿名化された作業タイムラインを提供するバックグラウンドサーバーです。個人分析や AI アシスタント向けのデータソースとして設計されています。

このサーバーは、通信に FastMCP、AI による匿名化に Ollama、アクティビティの追跡に標準的な Linux ツールを使用します。

機能

• アクティビティの記録：現在フォーカスされているウィンドウのタイトルを定期的に記録します。
• APM の追跡：キーボードとマウスのアクティビティに基づいて、アクション数／分（APM）を算出します。
• タイムラインの集約：連続するアクティビティをまとめて、圧縮された読みやすいタイムラインを作成します。
• 2 段階の匿名化：
  1. ハードコードされたフィルター：ユーザーが定義した機密キーワードを確実に削除します。
  2. LLM による匿名化：ローカルの Ollama モデルを使って、その他の個人を特定できる情報もインテリジェントに削除します。
• タイトルのサニタイズ：過度に長いウィンドウタイトルを整理して短縮します。
• 信頼性と設定の柔軟性：ログローテーション、正常なシャットダウンに対応し、すべての設定を別個の config.py ファイルで管理します。
• Systemd サービス：信頼性を最大限に高めるため、常駐型のバックグラウンドサービスとして実行できます。

要件

システム依存関係

重要

互換性に関する注意：このサーバーは、X11 ディスプレイサーバー上で動作する Linux デスクトップ環境専用に設計されています。X11 エコシステムのツールに依存するため、Windows、macOS、ネイティブの Wayland セッションでは動作しません。

次のコマンドラインツールとライブラリをインストールしてください。

• xdotool：アクティブなウィンドウタイトルの取得に使用します。
• xprintidle：ユーザーのアイドル時間の確認に使用します。
• ollama：ローカルの LLM の実行に使用します。
• PyGObject：D-Bus 通信（画面ロックの検出に使用）に使用します。

Debian/Ubuntu/Linux Mint では、次のコマンドですべてインストールできます。

sudo apt update
sudo apt install xdotool xprintidle python3-gi python3-gi-cairo gir1.2-gtk-3.0

Ollama については、公式のインストール手順に従ってください。インストール後、モデルを取得してください。

ollama pull gemma3

Python の依存関係

このプロジェクトには Python 3.8 以降が必要です。パッケージの管理には仮想環境を使用します。

インストールとセットアップ

1. リポジトリをクローンします：

   git clone https://github.com/your-username/focuslog.git
   cd focuslog
   

2. 仮想環境を作成します： システムの PyGObject ライブラリにアクセスできる仮想環境を作成する必要があります。

   python3 -m venv venv --system-site-packages
   

3. 環境を有効にして、パッケージをインストールします：

   source venv/bin/activate
   pip install -r requirements.txt
   deactivate
   

   （deactivate と入力すると、環境を終了できます）。

4. 設定ファイルを作成します：

   cp config.py.example config.py
   

5. 設定を編集します： テキストエディターで config.py を開きます。

   • 必ず FORBIDDEN_KEYWORDS リストに、常に削除したい個人データを追加してください。
   • 必要に応じて、OLLAMA_MODEL や MCP_PORT などの設定を調整します。

使い方

手動での起動（テスト用）

テストのためにサーバーを手動で実行するには、まず仮想環境を有効にします。

source venv/bin/activate
python focuslog.py

サーバーが起動し、コンソールにログが表示されます。停止するには Ctrl+C を押してください。

サービスとして実行する（推奨）

継続的かつ安定してバックグラウンドで動作させるには、FocusLog を systemd ユーザーサービスとして実行するのがおすすめです。ログイン時にサーバーが自動的に起動し、クラッシュした場合も再起動します。

1. サービスファイルを準備します：

   cp focuslog.service.example focuslog.service
   

2. focuslog.service を編集します： ファイルを開き、プレースホルダーのパスを実際のパスに置き換えます。

   • WorkingDirectory=/home/your_username/path/to/focuslog -> 例：WorkingDirectory=/home/dw/projects/focuslog
   • ExecStart=... -> venv/bin/python と focuslog.py のパスも更新します。
   • 重要：User= や Group= の行は追加しないでください。systemd --user が自動的に処理します。

3. サービスをインストールして有効にします：

   mkdir -p ~/.config/systemd/user
   cp focuslog.service ~/.config/systemd/user/
   systemctl --user daemon-reload
   systemctl --user enable --now focuslog.service
   

   --now フラグを指定すると、次回以降のログイン時に有効になるだけでなく、すぐに起動します。

4. サービスを管理します：

   • ステータスを確認： systemctl --user status focuslog.service
   • ログを表示： journalctl --user -u focuslog.service -f（ライブで追跡するには -f を指定）
   • 停止： systemctl --user stop focuslog.service
   • 起動： systemctl --user start focuslog.service

動作の仕組み

サーバーは、主に次の2つのバックグラウンドスレッドを実行します。

1. APM センサー：0.5秒ごとにユーザー入力を確認し、アクティビティの「ティック」カウンターを更新します。
2. ロガー：10秒ごとに、次の処理を行います。
   • 現在アクティブなウィンドウのタイトルを取得します。
   • タイトルをサニタイズします（短縮し、カスタムルールを適用します）。
   • 直近1分間のティック数を基に、現在の APM を計算します。
   • サニタイズしたタイトルと APM を SQLite データベースに保存します。

MCP クライアント経由で get_activity_log ツールが呼び出されると、次の処理を行います。

1. データベースから生データを取得します。
2. 重複しないすべてのウィンドウタイトルに対して2段階の匿名化を行い、パフォーマンス向上のため結果をキャッシュします。
3. データを整理されたタイムラインに集約します。
4. タイムラインを文字列として返します。

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細は LICENSE ファイルをご覧ください。