NeuroDock chronometric MCP server — time, idle, and break management.
Project description
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).
Status
v0.0.x implements the five tools specified in ADR 0001 — chronometric tool design:
| Tool | Status |
|---|---|
get_time_context |
implemented |
mark_session_start |
implemented; auto-closes prior open session |
mark_session_end |
implemented |
request_break_if_needed |
implemented |
idle_status |
implemented; 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.1: 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
- Tool design rationale: ADR 0001 — chronometric tool design.
- Authoritative schemas:
packages/mcp-chronometric/schemas/. - Project home: neurodock.org.
- Manifesto + ethics:
MANIFESTO.md,ETHICS.md.
Running
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.1:
privacy:
os_idle_consent: true # required for idle_status to perform the OS probe
chronometric:
zones: {} # reserved for v0.1.x profile-declared zone overrides
Development
uv sync --all-packages --all-extras
uv run pytest packages/mcp-chronometric/tests/ -v
uv run ruff check packages/mcp-chronometric/
uv run ruff format --check packages/mcp-chronometric/
uv run mypy --strict packages/mcp-chronometric/src/
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file neurodock_mcp_chronometric-0.0.2.tar.gz.
File metadata
- Download URL: neurodock_mcp_chronometric-0.0.2.tar.gz
- Upload date:
- Size: 23.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3d888e8f5838b3fba55fca83db31acd70ad359b7206aba1d1e6f939387814bed
|
|
| MD5 |
47b594cc165ae9b84ca0dbc1d6e4599f
|
|
| BLAKE2b-256 |
987d4c66a009f445eddc83b8a4ec7bf1a5538e1dfe1daf17874aabd151106084
|
File details
Details for the file neurodock_mcp_chronometric-0.0.2-py3-none-any.whl.
File metadata
- Download URL: neurodock_mcp_chronometric-0.0.2-py3-none-any.whl
- Upload date:
- Size: 17.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
188553ff631c71d9404ec441a5062a87caf5d02cd89c7c8935f16f77d85e1a06
|
|
| MD5 |
cd987d1c6e79046c305f2edeb0001f77
|
|
| BLAKE2b-256 |
04286ec9bcfeb19210daf0bba62fbd931c57aeea59ecf7879ca112f11226018d
|
