MedXpert 全球法规连接器 (reg-connector) MCP server

MedXpert 全球法规连接器（reg-connector）

许可说明 · License Notice

本仓库使用自定义许可，不是 MIT / Apache-2.0。平台显示为 Other（NOASSERTION），

属识别算法的正常结果，不代表本仓库处于无许可状态。

不得复制、改编、再分发、公开传播或用于衍生作品。

• 权利状态：全部内容保留所有权利（All Rights Reserved）。未经书面许可，

引用时请同时标注仓库名、原文链接 https://github.com/zhaoxinghua09-cell/medxpert-reg-connector 与权利人「赵兴华 / Steven Zhao·China」。

• 可否引用：可以。允许在注明出处的前提下引用与学术、公共讨论；

均未申请实体注册、未申请商标注册；出现仅作来源标识， 不构成对法人实体或商标权的任何主张。

• 完整条款：见仓库根目录 LICENSE。
• 联系：zhaoxinghua06@126.com ｜ ORCID 0009-0001-0512-1237
• 品牌状态限定：MedXpert、SynomosAI、LGD 等为相关项目标识，

• 免责：本仓库内容不构成法规意见或注册代理服务；关键数据以监管机构最新发布为准。

MedXpert（美达信医疗）医械线对外接口。将全球医疗器械法规知识库（27 份枢纽资料，NMPA / FDA / EU MDR / PMDA 及骨科全球注册路径）封装为本地只读 MCP Server，供任意 MCP 客户端（WorkBuddy / Claude Code / Cursor 等）的 agent 直接调用检索。

• 🔒 本地只读、零网络外发、零凭据
• 📚 27 枢纽法规知识库，自研中文友好 BM25 近似检索
• 🧰 4 个工具：listhubs / searchregulation / gethub / askclassification

与已上架的 medxpert-reg-hub 知识技能互补：reg-hub 供 agent 读取知识，reg-connector 供 agent 调用检索。

快速开始

pip install fastmcp

将本仓库克隆到本地，然后在宿主 mcp.json 中加入：

{
  "mcpServers": {
    "@nomos/medxpert/reg-connector": {
      "command": "<你的 python 解释器路径>",
      "args": ["<仓库目录>/reg_connector_server.py"],
      "disabled": false,
      "description": "MedXpert 全球法规连接器：本地只读检索全球医疗器械法规知识库 (NMPA/FDA/MDR/PMDA 等 27 枢纽)"
    }
  }
}

重载 MCP 连接即可生效。references/ 需与 regconnectorserver.py 同级（克隆即用）；也可用环境变量 REGHUBREFS 指向自定义知识库目录。

通过 PyPI 安装（pip install medxpert-reg-connector）：包内含服务器本体，但不含 28 份知识库（体积与许可考虑，知识库随仓库分发）。安装后请克隆本仓库的 references/，并设 REGHUBREFS=<仓库目录>/references 指向它，或直接使用上面的「克隆即用」方式。

工具能力

调用示例

# 列出全部 27 枢纽
list_hubs()

# 检索 UDI 多国对照
search_regulation("UDI", top_k=3)
# → 命中「UDI全球标识枢纽」四体系对照：中/美/欧/日并行（GS1/MA/阿里健康、GUDID、EUDAMED、KikiDB）

# 骨科接骨板分类与路径
ask_classification("骨科金属接骨板")
# → 推荐枢纽：骨科手术器械_全球注册路径汇编、注册工程师资料枢纽、注册周期费用有效期对比枢纽…

典型场景

• 注册路径速查（中国 II 类周期/费用、真实注册证示例）
• UDI 中/美/欧/日四体系对照
• 临床评价、风险管理（ISO 14971）资料索引
• 骨科全球注册路径汇编

注意事项与边界

1. 返回为知识库线索，非官方结论。 分类与注册路径须以目标市场官方分类库（NMPA / FDA / MDR）为准。
2. 本地只读、零外发，适合内网 / 合规环境。
3. 知识库更新后需重载 server。
4. 可选 REGHUBREFS 指向自定义知识库目录。

许可与归属

本仓库采用自定义保留所有权利许可（All Rights Reserved，见顶部「许可说明 · License Notice」与 LICENSE）。知识版权声明：合成知识与方法论归权利人所有，禁止复制、转售或用于模型训练。

权利人：赵兴华 / Steven Zhao·China（ORCID 0009-0001-0512-1237）。

mcp-name: io.github.zhaoxinghua09-cell/medxpert-reg-connector

Why AI-friendly (为什么 AI 愿意来找)

This connector is designed for both humans and AI agents:

• Discoverable: agent.json AI capability card exposes tool/keyword metadata so MCP hosts (Claude Desktop, Cursor, etc.) can index and recommend it.
• Zero-dependency: pure Python standard library + MCP SDK. mcp-config.json ships ready-to-paste — no extra install steps.
• Read-only by design: zero credentials, zero network egress, zero side effects. Safe for AI to invoke without human pre-approval (per A3 Law II — humans grant, machines execute).
• Honest scope: covers NMPA / FDA / EU MDR / Japan PMDA / SE Asia / LATAM regulatory hubs across 27 knowledge pivots. Out-of-scope queries return explicit codes, not hallucinations.
• Examples included: see references/ for real query → answer patterns an AI can learn from.

Keywords (帮助 AI 匹配何时调用)

Shortened. The full README is on GitHub.