a207-router-mcp

a207-router-mcp

Provides deterministic intent routing and safety gating for multi-agent systems, enforcing P0 critical word detection, mutually exclusive hard rules (MX-1/2/3), and a permission matrix as pure functions via four MCP tools.

Category
访问服务器

README

a207-router-mcp(M13 · 意图路由与安全闸)

调度 Agent 独占的确定性判定层。安全红线不交给概率模型:P0 危急词、三条互斥硬规则 (MX-1/MX-2/MX-3)、权限矩阵,全部落成可单测的纯函数。

  • 技术栈:FastMCP ≥2.0 + pydantic ≥2 + Python 3.13,stdio 传输
  • 依据:docs/01_多智能体与MCP总体需求梳理_v1.md §5/§6/§7、docs/02_Wave1_构建规格_v1.md §2.1
  • 零跨包引用:不 import 任何其他 a207-* 包,入参由调度 Agent 从 PCP 取值后显式传入

包结构

src/a207_router_mcp/
  core.py          安全闸 + 意图分类(纯逻辑,无 fastmcp)
  permissions.py   权限矩阵执行点 + 写工具识别(MX-3 落点)
  constants.py     角色、13 个 MCP 登记表、权限矩阵、写权策略
  lexicon.py       P0 危急词、分期词族、意图路由表、槽位词典
  slots.py         正则抽槽位
  models.py        pydantic 请求/响应模型
  server.py        FastMCP 实例,挂载四个工具
tests/test_tools.py  46 个断言,纯 python 可跑

四个工具

check_safety_gate(intent, caller, target_mcp="")

判定顺序固定:P0 危急词 → 入参登记校验 → MX-1 → MX-2 → MX-3 → 权限矩阵兜底。

返回:{allow, reason, applied_rule, gate, delegate_to, requires_confirmation, matched_keywords}

  • applied_rule:MX-1 | MX-2 | MX-3 | none
  • gate:P0_EMERGENCY | INPUT | MX | PERMISSION_MATRIX | PASS,用于区分同为 none 的拒绝来源
规则 内容
P0 命中危急词(抽搐/少尿/无尿/大量出血/意识不清等 30 余条)即断崖终止,不进入任何业务 MCP
MX-1 分期/eGFR/几期/肾小球滤过/PEW/生长障碍/血压百分位类问题,caller 为 nutritionist 或 parent_assistant 时拒绝并 delegate_to=doctor_assistant;a207-ckd-clinical-calc-mcp 对非 doctor_assistant 一律关闭
MX-2 a207-gamification-mcp 只接受 child_companion;child_companion 调 HIS/LIS/营养计算/临床计算/食谱/风险/报告/通知一律拒绝
MX-3 写工具 → 允许 caller:upsert_lab_result→doctor_assistant;upsert_food_diary→parent_assistant/child_companion;log_meal_checkin、award_badge→child_companion;push_to_emr→doctor_assistant(requires_confirmation=true);notify_*/trigger_warning_event/close_warning→risk_warning。工具与 target_mcp 不匹配同样拒绝

intent 可传用户原文,也可直接传工具名;中文写入说法(写回病历、录入化验、打卡等)已登记别名,避免绕过 MX-3。

classify_intent(text)

规则命中优先,未命中返回 intent="unknown" 且 fallback="llm",由上层软分类后再过一次安全闸。

返回:{intent, mcp, slots, confidence, allowed_callers, matched_keywords, candidates, fallback, note}

intent 目标 MCP 允许 caller
emergency_red_flag a207-router-mcp 全部(强制前置,fallback=halt)
patient_profile a207-his-mcp 调度/医生/营养师(RL)/家长(RL)/风险预警
clinical_staging a207-ckd-clinical-calc-mcp 仅 doctor_assistant
lab_result a207-lis-mcp 医生/家长(受限视图)/风险预警
nutrition_calc a207-nutrition-calc-mcp 医生/营养师/家长
meal_plan a207-meal-plan-mcp 医生/营养师
risk_assessment a207-risk-rules-mcp 医生/风险预警
nutrition_assessment a207-nutrition-assessment-mcp 见权限矩阵,写入按 MX-3
gamification a207-gamification-mcp 仅 child_companion
notify a207-notify-mcp 仅 risk_warning 可写
report a207-report-mcp 医生/营养师/家长(RL)/风险预警
knowledge a207-knowledge-mcp 全部,按角色切语料
followup a207-followup-mcp 医生/营养师/风险预警

打分口径:命中关键词长度求和,同分按优先级(P0→P5)取胜;confidence = min(0.95, 0.50 + 0.05 × 分数)。 "排食谱/一周食谱/三餐怎么安排"路由到 M7;裸词"食谱"按构建规格 §2.1 归 M5,由调用方结合上下文决定是否转交。

check_permission(caller, mcp, action="read")

需求文档 §7 权限矩阵的执行点。action 可传 read/write,也可直接传工具名。

返回:{allow, access, resolved_action, reason, write_tool, requires_confirmation, limited_view}

  • access 为矩阵原始格子:R / RL / R/W / -;limited_view=true 表示只能给受限视图
  • 精度说明:命中已登记写工具时,MX-3 映射优先于矩阵格子(v1.2 已用 MX-3 收口写入路径), 因此 parent_assistant + a207-nutrition-assessment-mcp + upsert_food_diary 放行,其余读操作仍按矩阵为 -。

extract_slots(text)

正则 + 词典抽槽位,抽不到留空,绝不猜测。

返回:{patient_id, food[], analyte[], date[], number[], age_years, weight_kg, height_cm, time_window_days, meal, measure[]}

  • patient_id 匹配 PCP 契约 ^P[0-9]{4,}$
  • analyte 归一到 PCP 字段名(potassium / phosphorus / scr / albumin / hemoglobin …),单位口径以 contracts/pcp-schema.json 为准:Scr μmol/L,K/P/Ca mmol/L,能量 kcal,蛋白 g,身高 cm,体重 kg
  • number 保留原始单位;斤自动折算 kg,月龄自动折算岁

验证

python -m py_compile src/a207_router_mcp/*.py
python tests/test_tools.py     # total=46 passed=46 failed=0

单测覆盖:MX-1/MX-2/MX-3 越权拒绝与正常放行、P0 断崖、未登记 caller/MCP、矩阵兜底、 意图路由 8 例、权限矩阵 6 组、槽位抽取 6 例,另含"无跨 a207 包引用 + 纯逻辑层不依赖 fastmcp"的静态自查。

启动(需先安装 fastmcp):fastmcp dev src/a207_router_mcp/server.py 或 python -m a207_router_mcp.server。

推荐服务器

Baidu Map

Baidu Map

百度地图核心API现已全面兼容MCP协议,是国内首家兼容MCP协议的地图服务商。

官方
精选
JavaScript
Playwright MCP Server

Playwright MCP Server

一个模型上下文协议服务器,它使大型语言模型能够通过结构化的可访问性快照与网页进行交互,而无需视觉模型或屏幕截图。

官方
精选
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

通过模型上下文协议启用与 Audiense Insights 账户的交互,从而促进营销洞察和受众数据的提取和分析,包括人口统计信息、行为和影响者互动。

官方
精选
本地
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

一个由人工智能驱动的工具,可以从自然语言描述生成现代化的用户界面组件,并与流行的集成开发环境(IDE)集成,从而简化用户界面开发流程。

官方
精选
本地
TypeScript
VeyraX

VeyraX

一个单一的 MCP 工具,连接你所有喜爱的工具:Gmail、日历以及其他 40 多个工具。

官方
精选
本地
Kagi MCP Server

Kagi MCP Server

一个 MCP 服务器,集成了 Kagi 搜索功能和 Claude AI,使 Claude 能够在回答需要最新信息的问题时执行实时网络搜索。

官方
精选
Python
graphlit-mcp-server

graphlit-mcp-server

模型上下文协议 (MCP) 服务器实现了 MCP 客户端与 Graphlit 服务之间的集成。 除了网络爬取之外,还可以将任何内容(从 Slack 到 Gmail 再到播客订阅源)导入到 Graphlit 项目中,然后从 MCP 客户端检索相关内容。

官方
精选
TypeScript
Neon MCP Server

Neon MCP Server

用于与 Neon 管理 API 和数据库交互的 MCP 服务器

官方
精选
Exa MCP Server

Exa MCP Server

模型上下文协议(MCP)服务器允许像 Claude 这样的 AI 助手使用 Exa AI 搜索 API 进行网络搜索。这种设置允许 AI 模型以安全和受控的方式获取实时的网络信息。

官方
精选
mcp-server-qdrant

mcp-server-qdrant

这个仓库展示了如何为向量搜索引擎 Qdrant 创建一个 MCP (Managed Control Plane) 服务器的示例。

官方
精选