NeuroDock Chronometric

io.github.tlennon-ie由 GitHub 帳號 tlennon-ie 發布v0.1.0更新於 Nov 3, 2026

Externalises time-of-day, session boundaries, and break prompts for time-blind users.

已驗證STDIO僅桌面位置與生活效率與工作流

概覽

AI 產生的概覽

本機 MCP 伺服器,為時間感知困難的使用者向助理提供目前時段、工作階段起訖、休息提醒與閒置狀態。

可以做什麼
  • 讀取目前時間脈絡與工作階段界線
  • 標記工作階段開始或結束,新的開始會自動關閉先前未結束的工作階段
  • 詢問是否需要休息並給出休息提示
  • 查詢閒置狀態,需在本機設定中授權
適用情境
適合時間感知困難或神經多樣性的使用者,希望助理在工作過程中追蹤時段、工作階段界線並提醒休息。目前是早期開發者預覽版,適合試驗而非仰賴它做長期記錄。
執行需求
以 stdio 方式在本機執行,透過 uv 或 pip 從 PyPI 安裝並以 uv run 啟動。需要本機設定檔 ~/.neurodock/profile.yaml,可用 NEURODOCK_PROFILE_PATH 覆寫路徑。未宣告驗證或 API 金鑰。
安裝前請注意
預覽版的工作階段狀態僅存於記憶體,重新啟動用戶端後未結束的工作階段會遺失並被視為自動關閉。作業系統閒置探測目前是空實作,不會回傳結果;閒置狀態僅在設定中開啟同意後才會執行。伺服器會讀取本機設定檔,使用前請確認該檔案內容。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 NeuroDock Chronometric,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

neurodock-mcp-chronometric

Time, idle, and break management as an MCP server. Part of NeuroDock — a local-first cognitive substrate for neurodivergent professionals.

Version: 0.0.2 (developer preview, in-memory).

Install

sh
uv add neurodock-mcp-chronometric# orpip install neurodock-mcp-chronometric

Use as an MCP server

Add to your ~/.claude.json (Claude Code) or claude_desktop_config.json (Claude Desktop):

json
{  "mcpServers": {    "neurodock-chronometric": {      "command": "uv",      "args": ["run", "neurodock-mcp-chronometric"]    }  }}

Status

v0.0.x implements the five tools specified in ADR 0001 — chronometric tool design:

ToolStatus
get_time_contextimplemented
mark_session_startimplemented; auto-closes prior open session
mark_session_endimplemented
request_break_if_neededimplemented
idle_statusimplemented; consent-gated, OS probe is a stub

Session state is intentionally in-memory for the v0.0.x preview — a single Claude session typically ends with an explicit mark_session_end so durable storage is not on the hot path. SQLite-backed session history is planned for v0.1.0 per ADR 0001; until then, restart Claude and any open session is treated as auto-closed on the next mark_session_start.

The OS idle probe is intentionally a no-op stub in v0.0.2: the consent gate is the hard correctness property, and the probe itself returns None on every platform until per-platform implementations and tests land.

References

Running

sh
uv run neurodock-mcp-chronometric

The server speaks the MCP stdio transport.

Profile

Reads ~/.neurodock/profile.yaml. Override with NEURODOCK_PROFILE_PATH (used in tests). Fields consumed in v0.0.2:

yaml
privacy:  os_idle_consent: true # required for idle_status to perform the OS probechronometric:  zones: {} # reserved for v0.1.x profile-declared zone overrides

Development

sh
uv sync --all-packages --all-extrasuv run pytest packages/mcp-chronometric/tests/ -vuv run ruff check packages/mcp-chronometric/uv run ruff format --check packages/mcp-chronometric/uv run mypy --strict packages/mcp-chronometric/src/

來源:packages/mcp-chronometric/README.md,提交 2d9cac6

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分