MCP.so
登录

Focuslog

@DragonsWho

代码仓库

关于 Focuslog

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

基本信息

分类

数据与分析

传输方式

stdio

发布者

DragonsWho

提交者

drags who

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 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.

FAQ from Focuslog

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.

评论

数据与分析 分类下的更多 MCP 服务器

Deep Research

u14app

Use any LLMs (Large Language Models) for Deep Research. Support SSE API and MCP server.

4.6K

Web3 Research MCP

aaronjmars

Deep Research for crypto - free & fully local

161

Bright Data MCP

luminati-io

A powerful Model Context Protocol (MCP) server that provides an all-in-one solution for public web access.

2.5K

arxiv-latex MCP Server

takashiishida

MCP server that uses arxiv-to-prompt to fetch and process arXiv LaTeX sources for precise interpretation of mathematical expressions in scientific papers.

140

MCP.science: Open Source MCP Servers for Scientific Research 🔍📚

pathintegral-institute

Open Source MCP Servers for Scientific Research

142