NeuroDock Guardrail

neurodock-mcp-guardrail

NeuroDock 的临床防护栏 MCP 服务。用于检测未经修改的大模型交互容易放大的三种模式，这些模式对神经多样性用户尤为明显：反刍循环（OCD）、不受调节的过度专注（ADHD），以及迎合／过度肯定。完整框架请参阅 ETHICS.md 和 MANIFESTO.md。

状态

• v0.0.2： 三种检测器均已上线。

  • check_rumination — 基于词语重叠的 Jaccard 启发式方法。
  • check_hyperfocus — 基于已用时阈值和日终时间的启发式方法。
  • check_sycophancy — 基于四种模式重叠的启发式方法。

  启发式方法公开透明，可供审查；阈值为默认值，并非处方。原理请参阅 ADR 0006。

工具

工具	状态	启发式方法	默认阈值
check_rumination	已上线（v0.0.1）	word_overlap_jaccard	时间窗口 90 分钟，次数 3，相似度 0.55
check_hyperfocus	已上线（v0.0.2）	elapsed_threshold_with_eod	60 / 90 / 120 分钟
check_sycophancy	已上线（v0.0.2）	模式重叠（4 种模式）	相似度 0.5

设计不变量

• 无状态。 服务不持久化任何内容——没有 SQLite、JSONL，也没有能在一次调用后保留的内存缓存。所有历史记录均由调用方提供。
• 无遥测数据，无网络套接字。 遵循 ETHICS.md 承诺 4。
• 日志不记录用户内容。 只记录 tool_invoked 元数据。
• v0.1.0 中覆盖令牌词汇表将保持封闭。 新增令牌须按 ADR 0006 §3 和 §10 的要求提升次要版本号并获得签字批准。
• 启发式方法可供审查。 每种启发式方法的源代码位于 src/neurodock_mcp_guardrail/heuristics/。修改这些代码须按 ETHICS.md 承诺 3 的要求获得签字批准。

用法

# 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)"

测试

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

测试涵盖：

• Jaccard 启发式方法（完全相同、互不重叠、仅停用词、释义、大小写不敏感、标点处理）。
• check_rumination 工具（空历史记录、时间窗口内检测、时间窗口外不检测、阈值校验、覆盖令牌约定、历史记录顺序拒绝、误报反馈路径）。
• check_hyperfocus（升级级别映射、日终严格性、空闲信号处理、覆盖令牌约定、架构符合性）。
• check_sycophancy（四种模式各自的测试、反向提示词生成、覆盖令牌约定、架构符合性）。
• 协议符合性：每个工具响应都会根据 schemas/ 中的架构文件进行验证。

许可证

AGPL-3.0-or-later。