de en ja ko ru zh

Vetroscope MCP

Name: Vetroscope MCP
Author: rankin-works

by rankin-works

Overview Schema Related Servers Score Discussions

TypeScript

Local

Vetroscope MCP

Model Context Protocol の読み取り専用サーバーで、Vetroscope 用 — LLM（Claude Desktop、Claude Code、ChatGPT、Cursor、…）に、時間の使い方、参加していたプロジェクト、目標に対する進捗状況のコンテキストを提供します。

ローカルの Vetroscope SQLite を直接読み取ります。読み取り専用です。クラウド往復なし、認証なし、オフラインで動作します。

ツール

レポートと内訳

ツール	機能
`get_report`	期間の集計レポート — アクティブ秒数の合計、上位アプリ、サブプロジェクトをネストした上位プロジェクト（YouTube 動画、SoundCloud の曲、Netflix のエピソード）。
`get_app_breakdown`	期間内の単一アプリのプロジェクト別内訳（サブプロジェクト付き）。
`get_app_stats`	1 つのアプリの詳細統計：累計合計、アクティブ日数、日次系列、時間帯分布、曜日分布。
`get_tag_breakdown`	単一タグの時間使用レポート — 上位アプリ、上位プロジェクト、日次系列、アクティブ/パッシブの内訳。`include_descendants` は親タグのサブツリーをロールアップします。
`get_tag_stats`	1 つのタグの詳細統計（`get_app_stats` のタグ版）：累計合計、アクティブ日数、日次系列、時間帯・曜日分布、さらにタグの親と子のロールアップ合計。`include_descendants` を渡すと親タグのサブツリー全体を系列にロールアップします。
`get_calendar`	任意期間の日別高密度系列（ヒートマップデータ）— デフォルトは 1 年分。
`get_device_breakdown`	複数のマシンで Vetroscope を実行している場合のデバイス別合計。
`get_music_split`	音楽と作業の分析：音楽あり作業 / 音楽のみ / 集中作業 / その他、さらにソース別（Spotify、SoundCloud、…）の重複合計。分類器は呼び出しごとに上書き可能。
`get_category_breakdown`	時間を Vetroscope のアクティビティカテゴリ（`coding`、`creative`、`productivity`、`communication`、`entertainment`、`music`、`gaming`、`browsing`、`system`、`other`）にロールアップ — Charts / Settings と同じ分類。
`get_listening_history`	ネイティブ音楽アプリとブラウザ音楽サイトのトップトラックとトップアーティスト、さらに日別のリスニング分数。アーティストは「アーティスト — タイトル」の sub_project 規約から解析。
`get_media_links`	実際に再生したメディアについて Vetroscope が取得した正規のディープリンク — Spotify の `spotify:track:…` URI と YouTube の `youtube.com/watch?v=…` URL — を対応する時間データと結合。Vetroscope ≥ 0.2.30 で `capture_media_links` が有効である必要があります。
`get_focus_heatmap`	アクティブなフォアグラウンド秒数の 7×24 グリッド — 特定の種類の作業を普段いつ行うか。アプリ / プロジェクト / タグのフィルタで単一アクティビティに絞り込めます。`include_descendants` は親タグのサブツリーをロールアップします。

参照 / 検索

ツール	機能
`list_tags`	タグの一覧（id、name、color、sticky フラグ、archived フラグ、ネストされたタグの parentId/parentName）。アーカイブされたタグはデフォルトで非表示（`include_archived` で表示）。
`list_categories`	アクティビティカテゴリの分類（id、label、color）— coding、creative、productivity など。
`list_projects`	これまでに追跡されたすべての（app、project）ペアと全期間の合計 + 初回/最終検出 + オプションの部分文字列検索。
`list_markers`	タイムラインマーカーの一覧（timestamp、label、color、icon、オプションのリージョン終了）。
`list_notes`	ノートの一覧（title、箇条書き/太字/斜体/@メンションを含む Markdown 風の本文抜粋、オプションの timestamp/region、pin、folder）。オプションの `folder` フィルタ（UUID、名前、または `none`）。
`list_note_folders`	ネストされたノートフォルダ（`uuid`、`name`、`parentUuid`、`path`、`color`）。
`list_reminders`	設定済みの 1 回限り、繰り返し、間隔、タグしきい値のリマインダー。無効なリマインダーはデフォルトで非表示（`include_disabled` で含める）。
`list_reminder_events`	リマインダー通知履歴。期間、未読ステータス、リマインダー UUID でフィルタ可能。

アクティビティ / ステータス

ツール	機能
`get_sessions`	連続アクティビティブロック（開始/終了/期間）—「今朝は何に取り組んだか」の自然な粒度。
`get_current_status`	最新のエントリ — 現在のアプリ/プロジェクト、どれだけ前か、追跡中 vs アイドル。
`query_entries`	生の 30 秒エントリのフィルタ付きリスト（app / project / tag / search / period / mode）。

目標

ツール	機能
`get_goals_progress`	設定済みのアプリ / 全体 / タグ目標に対する現在の進捗。
`get_goal_achievements`	どの日にどの目標を達成したかの履歴記録 — 連続記録の質問に使用。

すべての時間対応ツールは、次の共有フィルタを受け付けます。

引数	目的
`period`	`today`・`yesterday`・`week`・`month`・`year`・単一の日付 `YYYY-MM-DD`・範囲を含む `YYYY-MM-DD..YYYY-MM-DD`
`hour_start` / `hour_end`	ローカルタイムでの時間帯フィルタ（開始を含む / 終了を含まない）（例：`9` と `17` = 勤務時間）
`weekdays`	曜日の整数配列（0=日、1=月、…、6=土）。平日のみの場合は `[1,2,3,4,5]` を渡します。
`device`	`current`（ローカルマシン）、`get_device_breakdown` のデバイス UUID、またはプラットフォーム名（`darwin`、`win32`、`browser-extension`）。省略すると全デバイス。

すべての合計は、アクティブなフォアグラウンド時間とパッシブな離席リスニング時間（例：アイドル中のバックグラウンドミュージック）に分けられ、ダッシュボードの区別と一致します。

Related MCP server: SQLite MCP Server

要件

Vetroscope がインストールされ、少なくとも 1 回実行されていること。
Node.js 18+。

インストール

npx vetroscope-mcp

これだけです — グローバルインストールは不要です。初回実行時に npm からパッケージを取得します。

クライアントの設定

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集：

{
  "mcpServers": {
    "vetroscope": {
      "command": "npx",
      "args": ["-y", "vetroscope-mcp"]
    }
  }
}

Claude Desktop を再起動します。

Claude Code

claude mcp add vetroscope -- npx -y vetroscope-mcp

ChatGPT（開発者モード）

Connectors セクションで、コマンド npx、引数 -y vetroscope-mcp の新しい MCP サーバーを追加します。

Cursor

~/.cursor/mcp.json に追加：

{
  "mcpServers": {
    "vetroscope": {
      "command": "npx",
      "args": ["-y", "vetroscope-mcp"]
    }
  }
}

データベースの検出方法

Vetroscope は SQLite を次の場所に保存します。

macOS: ~/Library/Application Support/Vetroscope/
Windows: %APPDATA%\Vetroscope\
Linux: ~/.config/Vetroscope/

Vetroscope アカウントにサインインしている場合、アクティブな DB は vetroscope-<userId>.db（auth-state.json に記録）。それ以外は匿名の vetroscope.db。

どちらも環境変数で上書きできます。

環境変数	目的
`VETROSCOPE_DIR`	アプリデータディレクトリを上書き
`VETROSCOPE_DB_PATH`	明示的な `.db` ファイルを指定

プロンプト例

「今週 After Effects にどれだけ時間を費やしましたか？」
「昨日は何に取り組みましたか？」
「今日のコーディング目標を達成できそうですか？」
「今月触れた上位 3 つのプロジェクトは何ですか？」
「今週 'Vetroscope' プロジェクトに触れたすべてのセッションを表示してください。」
「今月 Vetroscope Dev タグにどれだけ時間を費やしましたか？」
「日中、普段いつ Cursor を使っていますか？」
「先週、平日の勤務時間（9–5）に集中作業を何時間しましたか？」
「昨日見た YouTube 動画とその長さは？」
「今何をしていますか？」
「今日の最長の集中作業セッションを表示してください。」
「コーディング目標を何日連続で達成していますか？」
「水曜日の 'Eye appointment' マーカーの期間中に何が起こっていましたか？」
「'Atlas' というプロジェクトに取り組んだことはありますか？」
「今年最も忙しかった日はいつですか？」
「今月のコーディング時間のうち、Mac と Windows のどちらでどれだけでしたか？」
「今週の作業のうち、音楽が流れていたのはどれくらいですか？」
「今日、他に何も開かずに音楽だけを聴いていた時間はどれくらいですか？」
「今月、クリエイティブな作業とコーディングをどれだけしましたか？」
「今週のトップ 5 アーティストは誰ですか？」
「週のどの時間帯に Cursor でコーディングしていますか？」

ローカル開発

git clone https://github.com/rankin-works/Vetroscope-MCP.git
cd Vetroscope-MCP
npm install
npm run build
node dist/index.js   # starts a stdio MCP server (mainly useful via a client)

型チェックのみ：

npm run typecheck

動作の仕組み

このサーバーは、Vetroscope が書き込むのと同じ SQLite データベースに対する薄いクエリアダプターです。electron/database.ts で使用されているバケットごとの重複を除いた時間計算をミラーリングしているため、合計はデスクトップダッシュボードと正確に一致します。

スキーマを直接読み取るため、Vetroscope のスキーマ移行によって MCP が壊れる可能性があります。ツールのセットは意図的に狭く設計されています — 汎用的な SQL サーフェスではなく、目的に特化したもの — そのため、変更は src/queries.ts に局所化されます。

安定性の保証

1.0.0 以降、vetroscope-mcp はセマンティックバージョニングに従います。公開 API サーフェス — ツール名、パラメータ名、パラメータのセマンティクス、レスポンスのフィールド名 — は安定しており、変更は以下のルールに従います：

変更	SemVer バンプ
新しいツールの追加	minor (1.x.0)
既存ツールへの新しいオプション引数の追加	minor
既存レスポンスへの新しいフィールドの追加	minor
ツール、引数、またはレスポンスフィールドの名前変更	major (2.0.0)
パラメータの許容値またはデフォルト値の変更	major
既存フィールドの意味の変更（例：秒 → 分）	major
ツール、引数、またはレスポンスフィールドの削除	major
以前は有効だった入力を壊すような検証の厳格化	major

API サーフェスを変更しないバグ修正や内部リファクタリングはパッチバンプ（1.0.x）です。

SemVer 契約の対象外と明示されているもの：

npm パッケージからエクスポートされない内部ヘルパーと型
src/categories.ts のアクティビティカテゴリ分類（ID は安定しています。Vetroscope のシードマッピングは時間の経過とともにより多くのアプリを分類する可能性があります）
ツール説明の正確な文言
エラーメッセージのテキスト

vetroscope-mcp の上に何かを構築し、メジャーバージョンに固定したい場合は、依存関係で ^1.0.0 にピン留めしてください。

完全なリリース履歴については CHANGELOG.md を参照してください。

ライセンス

MIT © Jacob Rankin

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

1dRelease cycle

4Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

Cursor DB MCP Server
Databases Developer Tools Documentation Access
jbdamask
F
license
Not graded
quality
D
maintenance
A Model Context Protocol server that enables AI assistants to explore and interact with Cursor IDE's SQLite databases, providing access to project data, chat history, and composer information.
Updated a year ago (2025-03-24 11:01 UTC)
25
SQLite MCP Server
Databases Developer Tools
santos-404
A
license
Not graded
quality
D
maintenance
A Model Context Protocol server implementation that enables AI assistants to execute SQL queries and interact with SQLite databases through a structured interface.
Updated a year ago (2025-04-23 09:37 UTC)
7
MIT
SQLite MCP Server
Databases Developer Tools Search
bhargava2019
A
license
Not graded
quality
D
maintenance
Implements a Model Context Protocol server that enables natural language interactions with SQLite databases, providing tools to list tables, retrieve schemas, count rows, and execute read-only SQL queries.
Updated a year ago (2025-07-27 11:26 UTC)
MIT
Productive Simple MCP
Documentation Access Finance Project Management
druellan
A
license
A
quality
A
maintenance
A Model Context Protocol (MCP) server for accessing Productive.io API endpoints (projects, tasks, comments, todos), tailored for read-only operations, providing streamlined access to essential data while minimizing token consumption
Updated 10 days ago (2026-08-14 17:41 UTC)
18
MIT

View all related MCP servers

Related MCP Connectors

hithereiamaliff-mcp-nextcloud
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
mcp
A Model Context Protocol server for Wix AI tools
classquill-mcp
Read-only MCP server for ClassQuill, a tutoring-business-management platform.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/rankin-works/Vetroscope-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

Vetroscope MCP

ツール

要件

インストール

クライアントの設定

Claude Desktop

Claude Code

ChatGPT（開発者モード）

Cursor

データベースの検出方法

プロンプト例

ローカル開発

動作の仕組み

安定性の保証

ライセンス

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

Cursor DB MCP Server

SQLite MCP Server

SQLite MCP Server

Productive Simple MCP

Related MCP Connectors

Latest Blog Posts

MCP directory API