NeuroDock Chronometric

neurodock-mcp-chronometric

MCP サーバーとして、時間、アイドル状態、休憩を管理します。NeuroDock の一部です。NeuroDock は、ニューロダイバージェントのプロフェッショナル向けに、ローカル優先の認知基盤を提供します。

バージョン： 0.0.2（開発者プレビュー、メモリ内）

インストール

uv add neurodock-mcp-chronometric
# or
pip install neurodock-mcp-chronometric

MCP サーバーとして使用する

~/.claude.json（Claude Code）または claude_desktop_config.json（Claude Desktop）に追加します。

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

ステータス

v0.0.x では、ADR 0001 — クロノメトリックツールの設計で規定されている5つのツールを実装しています。

ツール	ステータス
get_time_context	実装済み
mark_session_start	実装済み。前の未終了セッションを自動終了します
mark_session_end	実装済み
request_break_if_needed	実装済み
idle_status	実装済み。同意を必須とし、OS の確認処理はスタブです

v0.0.x プレビューでは、セッション状態を意図的にメモリ内に保持します。通常、1つの Claude セッションは明示的な mark_session_end で終了するため、永続ストレージは主要な処理経路ではありません。ADR 0001 に基づき、SQLite を利用したセッション履歴を v0.1.0 で実装する予定です。それまでは、Claude を再起動すると、未終了のセッションは次の mark_session_start で自動終了したものとして扱われます。

OS アイドル確認処理は、v0.0.2 では意図的に何もしないスタブです。同意の確認が正確性を担保する重要な要件であり、OS の確認処理自体は、プラットフォームごとの実装とテストが揃うまでは、すべてのプラットフォームで None を返します。

参考資料

• ツール設計の根拠：ADR 0001 — クロノメトリックツールの設計。
• 正式なスキーマ：packages/mcp-chronometric/schemas/。
• プロジェクトのホーム：neurodock.org。
• マニフェストと倫理方針：MANIFESTO.md、ETHICS.md。

実行

uv run neurodock-mcp-chronometric

このサーバーは MCP の標準入出力トランスポートを使用します。

プロファイル

~/.neurodock/profile.yaml を読み込みます。NEURODOCK_PROFILE_PATH で上書きできます（テストで使用）。v0.0.2 で使用するフィールドは次のとおりです。

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

開発

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/