NeuroDock chronometric MCP server — time, idle, and break management.
Project description
neurodock-mcp-chronometric
Time, idle, and break management as an MCP server.
Version: 0.0.1 (developer preview, in-memory).
Status
v0.0.1 implements the five tools specified Section 6 and ADR
0001-chronometric-tool-design.md:
| 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 in-memory only. SQLite persistence is tracked under the
# TODO: persist to SQLite marker in src/neurodock_mcp_chronometric/state.py
and lands before v0.1.0 ships.
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
- Spec: Section 6.
- Tool design rationale:
docs/decisions/0001-chronometric-tool-design.md. - Authoritative schemas:
packages/mcp-chronometric/schemas/.
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/
Release history Release notifications | RSS feed
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.1.tar.gz.
File metadata
- Download URL: neurodock_mcp_chronometric-0.0.1.tar.gz
- Upload date:
- Size: 22.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","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 |
1c3e5b2a41236e8a97043b08f8fd2dfea2f85772a9619b69544c71e57fd7b806
|
|
| MD5 |
893f101345518023b3be2ed149a9c902
|
|
| BLAKE2b-256 |
ca9ccd8dfb1b3f52874177566a3c3be943ee2ed6e06316f4f8951789574c3241
|
File details
Details for the file neurodock_mcp_chronometric-0.0.1-py3-none-any.whl.
File metadata
- Download URL: neurodock_mcp_chronometric-0.0.1-py3-none-any.whl
- Upload date:
- Size: 17.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","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 |
d20994e58f1484879916d42b99cd6848185744fc55907ef899b6c8b90594e5cd
|
|
| MD5 |
1e1d2afdd313098a3593b05b47f6cba6
|
|
| BLAKE2b-256 |
f986d369eb80031f86895644803d7b2bc76909c03cb389cacc30be90ea1b6879
|
