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 分