Skip to main content
Glama
deenjakoruzh
rankin-works

Vetroscope MCP

by rankin-works
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

Vetroscope MCP

Ein schreibgeschützter Model Context Protocol-Server für Vetroscope – gibt LLMs (Claude Desktop, Claude Code, ChatGPT, Cursor, …) Kontext darüber, wie du deine Zeit verbringst, in welchen Projekten du warst und wie du deine Ziele verfolgst.

Liest deine lokale Vetroscope-SQLite direkt, schreibgeschützt. Kein Cloud-Roundtrip, keine Authentifizierung, funktioniert offline.

Werkzeuge

Berichte & Aufschlüsselungen

Werkzeug

Was es tut

get_report

Aggregierter Bericht für einen Zeitraum – gesamte aktive Sekunden, Top-Apps, Top-Projekte mit verschachtelten Unterprojekten (YouTube-Videos, SoundCloud-Songs, Netflix-Episoden).

get_app_breakdown

Aufschlüsselung nach Projekten für eine einzelne App über einen Zeitraum, mit Unterprojekten.

get_app_stats

Detaillierte Statistiken für eine App: Gesamtwerte über die gesamte Zeit, aktive Tage, Tagesreihe, Verteilung nach Stunden, Verteilung nach Wochentagen.

get_tag_breakdown

Zeitaufwandsbericht für ein einzelnes Tag – Top-Apps, Top-Projekte, Tagesreihe, aktive/passive Aufteilung. include_descendants rollt den Unterbaum eines übergeordneten Tags auf.

get_tag_stats

Detaillierte Statistiken für ein Tag (Gegenstück zu get_app_stats): Gesamtwerte über die gesamte Zeit, aktive Tage, Tagesreihe, Stunden- und Wochentagsverteilungen, sowie das übergeordnete Tag und dessen Kinder mit aufgerollten Summen. Übergebe include_descendants, um den gesamten Unterbaum eines übergeordneten Tags in die Reihe einzubeziehen.

get_calendar

Dichte Tagesreihe (Heatmap-Daten) für einen beliebigen Zeitraum – standardmäßig ein ganzes Jahr.

get_device_breakdown

Gesamtwerte pro Gerät, wenn du Vetroscope auf mehreren Geräten ausführst.

get_music_split

Musik-vs-Arbeit-Analyse: Arbeit mit Musik / nur Musik / konzentrierte Arbeit / Sonstiges, plus Überlappungssummen pro Quelle (Spotify, SoundCloud, …). Der Klassifikator kann pro Aufruf überschrieben werden.

get_category_breakdown

Zeit, die in Vetroscope-Aktivitätskategorien zusammengefasst wird (coding, creative, productivity, communication, entertainment, music, gaming, browsing, system, other) – gleiche Taxonomie wie in Charts / Einstellungen.

get_listening_history

Top-Titel und Top-Künstler über native Musik-Apps und Browser-Musikseiten, plus Hörminuten pro Tag. Künstler werden aus der Konvention „Künstler — Titel“ im Unterprojekt geparst.

get_media_links

Kanonische Deep-Links, die Vetroscope für tatsächlich abgespielte Medien erfasst hat – Spotify-spotify:track:…-URIs und YouTube-youtube.com/watch?v=…-URLs – verknüpft mit den passenden Zeitdaten. Erfordert Vetroscope ≥ 0.2.30 mit aktiviertem capture_media_links.

get_focus_heatmap

7×24-Raster aktiver Vordergrundsekunden – wann du normalerweise bestimmte Arten von Arbeit erledigst. Optionaler App-/Projekt-/Tag-Filter, um auf eine einzelne Aktivität einzugrenzen; include_descendants rollt das Unterbaum eines übergeordneten Tags auf.

Referenz / Nachschlagen

Werkzeug

Was es tut

list_tags

Deine Tags mit ID, Name, Farbe, Sticky-Flag, Archiv-Flag und parentId/parentName für verschachtelte Tags. Archivierte Tags sind standardmäßig ausgeblendet (include_archived zum Anzeigen).

list_categories

Taxonomie der Aktivitätskategorien (id, label, color) – coding, creative, productivity und der Rest.

list_projects

Jedes jemals erfasste (App, Projekt)-Paar mit Gesamtwerten über die gesamte Zeit, erstem/letztem Gesehen und optionaler Teilstringsuche.

list_markers

Deine Timeline-Marker (Zeitstempel, Label, Farbe, Symbol, optionales Regionsende).

list_notes

Deine Notizen (Titel, markdown-ähnlicher Auszug mit Aufzählungen, Fett, Kursiv, @Erwähnungen, optionaler Zeitstempel/Region, Pin, Ordner). Optionaler folder-Filter (UUID, Name oder none).

list_note_folders

Verschachtelte Notizordner (uuid, name, parentUuid, path, color).

list_reminders

Konfigurierte einmalige, wiederkehrende, Intervall- und Tag-Schwellen-Erinnerungen. Deaktivierte Erinnerungen sind standardmäßig ausgeblendet (include_disabled zum Einbeziehen).

list_reminder_events

Verlauf der Erinnerungsbenachrichtigungen, filterbar nach Zeitraum, Ungelesen-Status oder Erinnerungs-UUID.

Aktivität / Status

Werkzeug

Was es tut

get_sessions

Kontinuierliche Aktivitätsblöcke (Start/Ende/Dauer) – die natürliche Granularität für „Was habe ich heute Morgen gemacht?“.

get_current_status

Neuester Eintrag – welche App/welches Projekt gerade, wie kürzlich, Tracking vs. Leerlauf.

query_entries

Gefilterte Liste der rohen 30-Sekunden-Einträge (App / Projekt / Tag / Suche / Zeitraum / Modus).

Ziele

Werkzeug

Was es tut

get_goals_progress

Aktueller Fortschritt bei konfigurierten App-/Gesamt-/Tag-Zielen.

get_goal_achievements

Historische Aufzeichnung, welche Ziele du an welchen Tagen erreicht hast – Grundlage für Serienfragen.

Alle zeitbezogenen Werkzeuge akzeptieren diese gemeinsamen Filter:

Argument

Zweck

period

today · yesterday · week · month · year · einzelnes Datum YYYY-MM-DD · inklusiver Bereich YYYY-MM-DD..YYYY-MM-DD

hour_start / hour_end

Inklusiver / exklusiver Stundenfilter in lokaler Zeit (z. B. 9 und 17 = Arbeitszeiten)

weekdays

Array von Wochentags-Integern (0=So, 1=Mo, …, 6=Sa). Übergebe [1,2,3,4,5] für nur Wochentage.

device

current (das lokale Gerät), eine Geräte-UUID aus get_device_breakdown oder ein Plattformname (darwin, win32, browser-extension). Weglassen für alle Geräte.

Jede Gesamtsumme wird aufgeteilt in aktive Vordergrundzeit und passive Abwärts-Hörzeit (z. B. Hintergrundmusik im Leerlauf), entsprechend der Unterscheidung im Dashboard.

Related MCP server: SQLite MCP Server

Anforderungen

  • Vetroscope installiert und mindestens einmal ausgeführt.

  • Node.js 18+.

Installation

npx vetroscope-mcp

Das war's – keine globale Installation nötig. Der erste Lauf lädt das Paket von npm.

Konfiguriere deinen Client

Claude Desktop

Bearbeite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Starte Claude Desktop neu.

Claude Code

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

ChatGPT (Entwicklermodus)

Füge im Abschnitt Connectors einen neuen MCP-Server mit dem Befehl npx und den Argumenten -y vetroscope-mcp hinzu.

Cursor

Füge zu ~/.cursor/mcp.json hinzu:

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

So findet es deine Datenbank

Vetroscope speichert seine SQLite unter:

  • macOS: ~/Library/Application Support/Vetroscope/

  • Windows: %APPDATA%\Vetroscope\

  • Linux: ~/.config/Vetroscope/

Wenn du mit einem Vetroscope-Konto angemeldet bist, ist die aktive Datenbank vetroscope-<userId>.db (gespeichert in auth-state.json). Andernfalls ist es die anonyme vetroscope.db.

Du kannst beide Teile mit Umgebungsvariablen überschreiben:

Umgebungsvariable

Zweck

VETROSCOPE_DIR

Überschreibt das App-Datenverzeichnis

VETROSCOPE_DB_PATH

Zeigt auf eine explizite .db-Datei

Beispiel-Prompts

  • "Wie viel Zeit habe ich diese Woche in After Effects verbracht?"

  • "Was habe ich gestern gearbeitet?"

  • "Bin ich heute auf Kurs, mein Coding-Ziel zu erreichen?"

  • "Was waren die drei wichtigsten Projekte, die ich diesen Monat angefasst habe?"

  • "Zeige mir alle Sitzungen, die diese Woche das Projekt 'Vetroscope' berührt haben."

  • "Wie viel Zeit habe ich diesen Monat mit dem Tag 'Vetroscope Dev' verbracht?"

  • "Wann am Tag nutze ich normalerweise Cursor?"

  • "Wie viele Stunden konzentrierter Arbeit habe ich letzte Woche während der Arbeitszeiten an Wochentagen (9–5) geleistet?"

  • "Welche YouTube-Videos habe ich gestern angesehen und wie lange?"

  • "Was mache ich gerade?"

  • "Zeige mir meine längsten konzentrierten Arbeitssitzungen heute."

  • "Wie viele Tage in Folge habe ich mein Coding-Ziel erreicht?"

  • "Was geschah während meines Markers 'Augenarzttermin' am Mittwoch?"

  • "Habe ich jemals an einem Projekt namens 'Atlas' gearbeitet?"

  • "Was war mein geschäfttestes Tag dieses Jahr?"

  • "Wie viel meiner Coding-Zeit war diesen Monat auf meinem Mac vs. Windows?"

  • "Wie viel meiner Arbeit diese Woche hatte Musik im Hintergrund?"

  • "Wie lange habe ich heute nur Musik gehört, ohne etwas anderes geöffnet zu haben?"

  • "Wie viel kreative Arbeit vs. Coding habe ich diesen Monat gemacht?"

  • "Wer waren meine Top fünf Künstler diese Woche?"

  • "Wann in der Woche codiere ich normalerweise in Cursor?"

Lokale Entwicklung

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)

Nur Typprüfung:

npm run typecheck

So funktioniert es

Der Server ist ein dünner Query-Adapter über derselben SQLite-Datenbank, in die Vetroscope schreibt. Er spiegelt die Bucket-getrennte Dauerberechnung aus electron/database.ts, sodass die Summen exakt mit dem Desktop-Dashboard übereinstimmen.

Da er das Schema direkt liest, könnte eine Schema-Migration von Vetroscope den MCP beschädigen. Die Tool-Auswahl ist bewusst schmal — zweckorientiert statt einer generischen SQL-Oberfläche — sodass sich Änderungen auf src/queries.ts beschränken.

Stabilitätsgarantien

Ab 1.0.0 folgt vetroscope-mcp den Regeln von Semantic Versioning. Die öffentliche API-Oberfläche — Tool-Namen, Parameternamen, Parametersemantik und Antwortfeldnamen — ist stabil, und Änderungen folgen diesen Regeln:

Änderung

SemVer-Stage

Hinzufügen eines neuen Tools

minor (1.x.0)

Hinzufügen eines neuen optionalen Arguments zu einem vorhandenen Tool

minor

Hinzufügen eines neuen Feldes zu einer vorhandenen Antwort

minor

Umbenennen eines Tools, Arguments oder Antwortfeldes

major (2.0.0)

Ändern der akzeptierten Werte oder des Standardwerts eines Parameters

major

Ändern der Bedeutung eines vorhandenen Feldes (z. B. Sekunden → Minuten)

major

Entfernen eines Tools, Arguments oder Antwortfeldes

major

Verschärfen der Validierung, die bisher gültige Eingaben ungültig macht

major

Fehlerkorrekturen und interne Refactorings, die die API-Oberfläche nicht verändern, sind Patch-Versionen (1.0.x).

Ausdrücklich nicht Teil des SemVer-Vertrags sind:

  • Interne Helfer und Typen, die nicht aus dem npm-Paket exportiert werden

  • Die Taxonomie der Aktivitätskategorien in src/categories.ts (IDs bleiben stabil; Seed-Zuordnungen in Vetroscope können im Laufe der Zeit mehr Apps einordnen)

  • Der exakte Wortlaut der Tool-Beschreibungen

  • Fehlermeldungstexte

Wenn du etwas auf der Grundlage von vetroscope-mcp erstellst und an eine Hauptversion binden möchtest, setze in deiner Abhängigkeit das Pinning auf ^1.0.0.

Siehe CHANGELOG.md für den vollständigen Versionsverlauf.

Lizenz

MIT © Jacob Rankin

Install Server
A
license - permissive license
A
quality
A
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
1dRelease cycle
4Releases (12mo)
Commit activity

Resources

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

  • SQLite MCP Server

    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.
    7
    MIT

  • SQLite MCP Server

    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.
    MIT

  • Productive Simple MCP

    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
    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

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