Focuslog MCP Server

@DragonsWho

リポジトリ

基本情報

カテゴリ

データと分析

トランスポート

stdio

作者

DragonsWho

投稿者

drags who

Focuslog MCP Server について

A background server that logs your desktop activity, calculates your Actions Per Minute (APM), and provides a clean, anonymized timeline of your work on demand. It's designed to be a data source for personal analytics or AI assistants.

#activity-tracking#apm #logging#anonymization#ollama #linux#x11#self-hosted#personal-analytics

Focuslog MCP Server の設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "focuslog": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/DragonsWho/FocusLog"
      ],
      "env": {}
    }
  }
}

Focuslog MCP Server のツール

ツール一覧はまだありません

この掲載には表示できるツール一覧がまだありません。サーバーにツールがないという意味ではありません。対応機能はプロジェクトのドキュメントをご確認ください。

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is Focuslog?

Focuslog is a background server for Linux (X11) that logs desktop activity, calculates Actions Per Minute (APM), and provides an anonymized timeline of work on demand. It is designed for personal analytics or AI assistants.

How to use Focuslog?

Install system dependencies (xdotool, xprintidle, pygobject, ollama), then clone the repository, create a virtual environment with --system-site-packages, install Python packages from requirements.txt, and copy config.py.example to config.py to set forbidden keywords and other options. Start manually with python focuslog.py in the venv, or deploy as a systemd --user service for continuous background operation.

Key features of Focuslog

Periodically records the title of the currently focused window.
Tracks keyboard and mouse activity to compute Actions Per Minute.
Groups consecutive activities into a compressed timeline.
Two‑stage anonymization: hard-coded keyword filter plus local Ollama LLM.
Sanitizes excessively long window titles.
Configurable settings in a separate config.py file.
Can run as a persistent systemd background service.

Use cases of Focuslog

Personal productivity analytics by reviewing anonymized desktop activity timelines.
Providing a work‑session summary to an AI assistant for time logging or task analysis.
Monitoring focus patterns over hours or days without exposing sensitive window titles.

よくある質問

What operating systems does Focuslog support?

Focuslog is designed specifically for Linux desktop environments using the X11 display server. It does not work on Windows, macOS, or native Wayland sessions.

What are the system dependencies?

You must have `xdotool`, `xprintidle`, `ollama` (with a pulled model, e.g., `gemma3`), and PyGObject (`python3-gi` and related packages) installed.

How does anonymization work?

Focuslog uses two stages: a hard-coded list of forbidden keywords (set in `config.py`) is removed first, then a local Ollama LLM intelligently removes any other personally identifiable information.

Where is the activity data stored?

Data is saved to a local SQLite database (no external service). The raw records are anonymized on demand when the `get_activity_log` tool is called.

Can Focuslog run automatically on login?

Yes. It can be installed as a `systemd --user` service that starts on login and restarts if it crashes. Setup instructions are provided in the README.

「データと分析」の他のコンテンツ

Zillow MCP Server

HasData

HasData's hosted Zillow MCP server lets AI agents search homes for sale, rentals and sold listings, then retrieve property details, price history and Zillow estimates as structured JSON.

PermitIntel

PermitIntel.ai

Building permit data and Florida contractor license checks over MCP. 81.8M permit records from the cities and counties that issue them, across 51 states. Four tools: verify_license, search_permits, lookup_contractor, roo

Tracetify — Competitor Ads, Growth Traces & Search Console

tracetify

17 tools for marketing and SEO research inside Claude Code, Cursor, Codex or ChatGPT: the ads any domain runs on Meta and Google, how a product grew from 12 public sources with every claim linked, your own Search Console

Instagram MCP Server