Skip to main content
Glama
deenjakoruzh
rankin-works

Vetroscope MCP

by rankin-works
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

Vetroscope MCP

Сервер Model Context Protocol только для чтения для Vetroscope — предоставляет LLM (Claude Desktop, Claude Code, ChatGPT, Cursor, …) контекст о том, как вы проводите время, в каких проектах участвуете и как продвигаетесь к своим целям.

Читает ваш локальный SQLite Vetroscope напрямую, только для чтения. Без облачных запросов, без аутентификации, работает офлайн.

Инструменты

Отчеты и разбивки

Инструмент

Описание

get_report

Сводный отчет за период — общее количество активных секунд, топ приложений, топ проектов с вложенными подпроектами (видео YouTube, песни SoundCloud, эпизоды Netflix).

get_app_breakdown

Разбивка по проектам для одного приложения за период, с подпроектами.

get_app_stats

Подробная статистика по одному приложению: общие итоги за все время, активные дни, дневные ряды, распределение по часам дня, распределение по дням недели.

get_tag_breakdown

Отчет о затраченном времени по одному тегу — топ приложений, топ проектов, дневные ряды, разбивка активное/пассивное. include_descendants сворачивает поддерево родительского тега.

get_tag_stats

Подробная статистика по одному тегу (аналог get_app_stats): общие итоги за все время, активные дни, дневные ряды, распределения по часам дня и дням недели, а также родительский тег и его дочерние элементы с суммарными итогами. Передайте include_descendants, чтобы включить все поддерево родительского тега в ряды.

get_calendar

Плотный подневный ряд (данные тепловой карты) за любой период — по умолчанию за полный год.

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

Топ треков и топ исполнителей в нативных музыкальных приложениях и музыкальных сайтах в браузере, плюс минуты прослушивания по дням. Исполнители извлекаются из соглашения о подпроектах "Исполнитель — Название".

get_media_links

Канонические глубокие ссылки, которые Vetroscope сохранил для реально воспроизведенного медиа — URI Spotify spotify:track:… и URL YouTube youtube.com/watch?v=… — объединенные с соответствующими данными о времени. Требуется Vetroscope ≥ 0.2.30 с включенным capture_media_links.

get_focus_heatmap

Сетка 7×24 активных секунд на переднем плане — когда вы обычно выполняете определенные виды работы. Необязательный фильтр по приложению / проекту / тегу для сужения до одной активности; include_descendants сворачивает поддерево родительского тега.

Справочник / поиск

Инструмент

Описание

list_tags

Ваши теги с id, именем, цветом, флагом закрепления, флагом архивации и parentId/parentName для вложенных тегов. Архивные теги скрыты по умолчанию (include_archived для показа).

list_categories

Таксономия категорий активности (id, label, color) — coding, creative, productivity и остальные.

list_projects

Каждая пара (приложение, проект), когда-либо отслеживаемая, с итогами за все время + первое/последнее появление + необязательный поиск по подстроке.

list_markers

Ваши маркеры временной шкалы (timestamp, label, color, icon, необязательный конец области).

list_notes

Ваши заметки (заголовок, выдержка из тела в стиле markdown с маркерами/жирным/курсивом/@упоминаниями, необязательные timestamp/область, закрепление, папка). Необязательный фильтр folder (UUID, имя или none).

list_note_folders

Вложенные папки заметок (uuid, name, parentUuid, path, color).

list_reminders

Настроенные одноразовые, повторяющиеся, интервальные и пороговые по тегам напоминания. Отключенные напоминания скрыты по умолчанию (include_disabled для включения).

list_reminder_events

История уведомлений напоминаний, фильтруемая по периоду, статусу прочтения или UUID напоминания.

Активность / статус

Инструмент

Описание

get_sessions

Непрерывные блоки активности (начало/конец/длительность) — естественная детализация для вопроса "над чем я работал этим утром".

get_current_status

Самая последняя запись — какое приложение/проект сейчас, как давно, отслеживание или простой.

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 (локальная машина), UUID устройства из get_device_breakdown или имя платформы (darwin, win32, browser-extension). Опустите для всех устройств.

Каждый итог разделяется на активное время на переднем плане и пассивное время прослушивания в фоне (например, фоновая музыка в простое), что соответствует различию на панели управления.

Related MCP server: SQLite MCP Server

Требования

  • Vetroscope установлен и запущен хотя бы один раз.

  • 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 (Developer Mode)

В разделе Connectors добавьте новый MCP-сервер с командой npx и аргументами -y vetroscope-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, активная база данных — vetroscope-<userId>.db (записана в auth-state.json). В противном случае это анонимная vetroscope.db.

Вы можете переопределить любую из этих частей с помощью переменных окружения:

Переменная окружения

Назначение

VETROSCOPE_DIR

Переопределить каталог данных приложения

VETROSCOPE_DB_PATH

Указать явный файл .db

Примеры запросов

  • "Сколько времени я провел в After Effects на этой неделе?"

  • "Над чем я работал вчера?"

  • "Успеваю ли я достичь своей цели по программированию сегодня?"

  • "Какие три проекта я чаще всего затрагивал в этом месяце?"

  • "Покажи мне все сессии, которые касались проекта 'Vetroscope' на этой неделе."

  • "Сколько времени я потратил на тег Vetroscope Dev в этом месяце?"

  • "В какое время дня я обычно использую Cursor?"

  • "Сколько часов сосредоточенной работы я сделал в будние рабочие часы (9–5) на прошлой неделе?"

  • "Какие видео на YouTube я смотрел вчера и как долго?"

  • "Что я делаю прямо сейчас?"

  • "Покажи мои самые длинные сессии сосредоточенной работы сегодня."

  • "Сколько дней подряд я достигаю своей цели по программированию?"

  • "Что происходило во время моего маркера 'Eye appointment' в среду?"

  • "Работал ли я когда-нибудь над проектом под названием 'Atlas'?"

  • "Какой день был самым загруженным в этом году?"

  • "Сколько времени на программирование я провел на Mac по сравнению с Windows в этом месяце?"

  • "Сколько моей работы на этой неделе сопровождалось музыкой?"

  • "Сколько времени я сегодня просто слушал музыку, не открывая ничего другого?"

  • "Сколько творческой работы по сравнению с программированием я сделал в этом месяце?"

  • "Кто были мои пять лучших исполнителей на этой неделе?"

  • "В какие дни недели я обычно программирую в 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

Как это работает

Сервер — это тонкий адаптер запросов поверх той же SQLite-базы, в которую пишет Vetroscope. Он повторяет побакетный расчёт длительности из electron/database.ts, чтобы итоги точно совпадали с десктопной панелью управления.

Поскольку сервер читает схему напрямую, миграция схемы Vetroscope может сломать MCP. Набор инструментов намеренно узкий — специализированный, а не универсальный SQL-интерфейс, — поэтому изменения ограничиваются src/queries.ts.

Гарантии стабильности

Начиная с 1.0.0, vetroscope-mcp следует семантическому версионированию. Публичная поверхность API — имена инструментов, имена параметров, семантика параметров и имена полей ответов — стабильна, и изменения подчиняются следующим правилам:

Изменение

Повышение SemVer

Добавление нового инструмента

минорная (1.x.0)

Добавление нового необязательного аргумента к существующему инструменту

минорная

Добавление нового поля в существующий ответ

минорная

Переименование инструмента, аргумента или поля ответа

мажорная (2.0.0)

Изменение допустимых значений параметра или значения по умолчанию

мажорная

Изменение смысла существующего поля (например, секунды → минуты)

мажорная

Удаление инструмента, аргумента или поля ответа

мажорная

Ужесточение валидации, которое ломает ранее допустимые входные данные

мажорная

Исправления ошибок и внутренние рефакторинги, не меняющие поверхность API, считаются патч-обновлениями (1.0.x).

Что явно не входит в условия SemVer:

  • Внутренние хелперы и типы, не экспортируемые из npm-пакета

  • Таксономия категорий активности в src/categories.ts (идентификаторы остаются стабильными; начальные сопоставления в Vetroscope могут со временем классифицировать больше приложений)

  • Точные формулировки описаний инструментов

  • Текст сообщений об ошибках

Если вы создаёте что-то на основе vetroscope-mcp и хотите зафиксировать мажорную версию, укажите ^1.0.0 в зависимостях.

Полную историю релизов см. в CHANGELOG.md.

Лицензия

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