NeuroDock Guardrail

io.github.tlennon-ie由 GitHub 帳號 tlennon-ie 發布v0.0.5更新於 Oct 24, 2026

Advisory detectors for rumination, hyperfocus, and sycophancy. Never silently blocks.

已驗證STDIO僅桌面安全與監控AI 與機器學習

概覽

AI 產生的概覽

以建議方式偵測對話中的反芻循環、失控的過度專注與諂媚傾向，不會默默封鎖對話。

可以做什麼
NeuroDock Guardrail 提供三個建議性工具：check_rumination 依呼叫端提供的歷史視窗進行詞重疊 Jaccard 啟發式偵測；check_hyperfocus 採用經過時間門檻並結合當日結束的處理；check_sycophancy 比對四種過度認同模式。每個工具會回傳偵測結果，門檻有預設值且可由呼叫端調整。此伺服器為無狀態、不保存任何內容，也不會默默封鎖對話。
適用情境
當助理服務或搭配神經多樣性族群使用，且希望對重複循環、失控的長時間專注或過度附和取得輕量且可稽核的提示時，適合加入。它僅提供建議，因此適合由助理或使用者自行決定如何處理標記、而非自動攔阻的情境。
執行需求
以 stdio 本機程序執行，從 PyPI 安裝 neurodock-mcp-guardrail，並以 uvx 或主控台指令碼啟動。未宣告任何帳號、API 金鑰、環境變數、標頭或網路存取。由於伺服器不儲存任何內容，對話歷史必須由呼叫端自行提供。
安裝前請注意
偵測基於啟發式與門檻，誤判與漏判都在預期之內，應將標記視為提示而非臨床判斷。伺服器為無狀態、不保留歷史，結果完全取決於呼叫端傳入的內容。它宣告不使用遙測、不開放網路通訊端，僅記錄工具呼叫的中繼資料。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

neurodock-mcp-guardrail

Clinical guardrails MCP server for NeuroDock. Detects three patterns that unmodified LLM interaction tends to amplify for neurodivergent users: rumination loops (OCD), unregulated hyperfocus (ADHD), and sycophancy / over-validation. See ETHICS.md and MANIFESTO.md for the full framework.

Status

  • v0.0.2: All three detectors are live.

    • check_rumination — word-overlap Jaccard heuristic.
    • check_hyperfocus — elapsed-threshold-with-end-of-day heuristic.
    • check_sycophancy — four-pattern overlap heuristic.

    Heuristics are public and auditable; thresholds are defaults, not prescriptions. See ADR 0006 for the rationale.

Tools

ToolStatusHeuristicDefault thresholds
check_ruminationlive (v0.0.1)word_overlap_jaccardwindow 90 min, count 3, similarity 0.55
check_hyperfocuslive (v0.0.2)elapsed_threshold_with_eod60 / 90 / 120 minutes
check_sycophancylive (v0.0.2)pattern overlap (4 patterns)similarity 0.5

Design invariants

  • Stateless. The server persists nothing — no SQLite, no JSONL, no in-memory caches that survive a call. Callers supply all history.
  • No telemetry, no network sockets. Per ETHICS.md commitment 4.
  • No user content in logs. Only tool_invoked metadata is logged.
  • Override-token vocabulary is closed at v0.1.0. New tokens require a minor bump and sign-off per ADR 0006 §3 and §10.
  • Heuristics are auditable. Source for each heuristic lives in src/neurodock_mcp_guardrail/heuristics/. Changes there require sign-off per ETHICS.md commitment 3.

Usage

bash
# Run the server over stdio (via the console script):neurodock-mcp-guardrail
# Or smoke-test the build directly:python -c "from neurodock_mcp_guardrail import server; print(server.app.name)"

Tests

bash
uv run pytest packages/mcp-guardrail/tests/ -v

Tests cover:

  • The Jaccard heuristic (identical, disjoint, stopword-only, paraphrase, case-insensitivity, punctuation handling).
  • The check_rumination tool (empty history, in-window detection, out-of-window non-detection, threshold honour, override-token contract, history-ordering rejection, false-positive-feedback path).
  • check_hyperfocus (escalation level mapping, end-of-day strictness, idle-signal handling, override-token contract, schema conformance).
  • check_sycophancy (each of the four patterns, counter-prompt generation, override-token contract, schema conformance).
  • Protocol conformance: every tool response is validated against the schema files in schemas/.

License

AGPL-3.0-or-later.

來源：packages/mcp-guardrail/README.md，提交 2d9cac6

工具

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

版本歷史

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

評分

已滿足適用檢查項的 50%

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

  • 近 30 天內可連通25 分

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

  • 已宣告認證方式10 分

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

  • 已列出工具15 分

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

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