Activitywatch MCP Server

🚀 活動観察 MCP サーバー

活動観察 (ActivityWatch) は、ユーザーの活動を追跡し分析するツールです。この MCP（モデルコンテキストプロトコル）サーバーを使用すると、Claude などの AI ツールを通じて ActivityWatch とやり取りし、ユーザーの活動データを照会および分析することができます。

✨ 主な機能

• 活動データの収集：ActivityWatch から詳細なユーザー活動データを収集します。
• 時間範囲の絞り込み：指定した期間のデータ照会をサポートします。
• 複数条件のフィルタリング：アプリケーションや状態（例：アイドル状態かどうか）などの条件でデータをフィルタリングできます。
• データの集計：活動データをアプリケーションやその他の属性で集計および統計することができます。

📦 インストール

npm からのインストール

npm install activitywatch-mcp-server

ソースコードからのビルドとインストール

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

   git clone https://github.com/yourusername/activitywatch-mcp-server.git
   cd activitywatch-mcp-server
   

2. 依存関係をインストールします：

   npm install
   

3. サービスを起動します：

   npm start
   

前提条件

• Node.js と npm がインストールされていること。
• ActivityWatch サーバーが実行中で、デフォルトのアドレス http://localhost:5600 でアクセス可能であること。

💻 使用例

基本的な使用法

ActivityWatch への接続

デフォルトでは http://localhost:5600 に接続します。変更する場合は、ソースコード内の設定を修正してください。

ブラウザ活動の取得

{
  "timeperiods": ["2024-10-28/2024-10-29"],
  "query": ["browser_events = query_bucket('aw-watcher-web'); RETURN = browser_events;"]
}

アイドル状態のフィルタリング

{
  "timeperiods": ["2024-10-28/2024-10-29"],
  "query": [
    "afk_bucket = query_bucket('aw-watcher-afk_');",
    "not_afk_events = filter_keyvals(afk_bucket, 'status', ['not-afk']);",
    "window_events = query_bucket('aw-watcher-window_');",
    "final_events = filter_period_intersect(window_events, not_afk_events);",
    "RETURN = final_events;"
  ]
}

高度な使用法

ウィンドウイベントの取得

window_events = query_bucket(find_bucket("aw-watcher-window_"));
RETURN = window_events;

アプリケーション別のグループ化

window_events = query_bucket(find_bucket("aw-watcher-window_"));
events_by_app = merge_events_by_keys(window_events, ["app"]);
RETURN = sort_by_duration(events_by_app);

📚 ドキュメント

設定

デフォルトの接続アドレスは http://localhost:5600 です。変更する場合は、コード内の該当する設定を修正してください。

トラブルシューティング

ActivityWatch が実行されていない場合

サービスで接続エラーが発生した場合は、ActivityWatch が起動しており、http://localhost:5600 からアクセスできることを確認してください。

照会エラー

• 照会構文を確認してください。
• バケット ID が正しいことを確認してください。
• 指定した期間にデータが存在することを検証してください。
• ActivityWatch のログを確認して詳細情報を取得してください。

問題の注意点

Claude を使用して照会を実行する際は、JSON 形式が正しいことを確認してください。特に、すべての照会文を1つの文字列に入れる必要があります。

{
  "timeperiods": ["2024-10-28/2024-10-29"],
  "query": ["statement1; statement2; RETURN = result;"]
}

🤝 貢献

貢献を歓迎します！いつでも Pull Request を送信してください。

📄 ライセンス

MIT