Skip to main content

medxpert-ortho-mcp · Orthopedic device testing connector

mcp-name: io.github.zhaoxinghua09-cell/medxpert-ortho-mcp

English first, Chinese below.

An MCP server with 8 tools for orthopedic device testing work: lab matching, quotation estimation, UDI checks, dual-temporal standards lookup, class/path judgment trees, region routes, registration timelines and gap reports. Offline, standard library only, zero dependencies.

It exists because four MedXpert expert packs (medxpert-standards, medical-device-reg-translator, medical-device-testing-link, med-device-compliance-toolkit) had been referencing a connector called medxpert-ortho-mcp that was never built. This is that connector, built.

What is real and what is sample

Aspect Status
The server, the 8 tools, the protocol layer Real. Implemented, unit-tested, published to PyPI and to the official MCP Registry
The datasets shipped in datasets/ Sample. Invented labs, invented prices, invented UDI-DIs. Illustrative only
Every tool result Carries sample_data: true until you set ORTHO_DATA_DIR

The bundled data is not an accreditation directory, not a price commitment, and not a regulatory conclusion. Point ORTHO_DATA_DIR at your own JSON files to use real evidence.

Run

uvx medxpert-ortho-mcp          # stdio MCP server
python -m medxpert_ortho.server --selftest   # offline self-test, no host needed

MCP host configuration:

{"mcpServers": {"medxpert-ortho-mcp": {"command": "uvx", "args": ["medxpert-ortho-mcp"]}}}

Custom data directory:

{"mcpServers": {"medxpert-ortho-mcp": {
  "command": "uvx", "args": ["medxpert-ortho-mcp"],
  "env": {"ORTHO_DATA_DIR": "/path/to/your/datasets"}}}}

Tools

Tool What it does Honest limit
match_labs Ranks labs by capability keyword, region and device description Sample data has 3 labs and a few capability items
calc_quote Price range by lab and scope, total estimated by quantity (>included samples +12%) Prices are illustrative; not a commercial offer
check_udi 14-digit UDI-DI lookup, returns class / sterile / single-use Misses are explained as sample-data scope, not proof of absence
query_standard Keyword search with as_of dual-temporal judgement (in force? superseded?) Status fields are demo logic; verify against the official current version
find_judgment_tree Step-by-step classification / route questions A demo tree, not a review decision
get_region_path Authority, route note and required documents per region Sample routes only for CN / CN-JS / CN-SH
check_timeline Expands relative days into calendar dates, marks completed / in_progress / not_started, flags overdue Durations are illustrative; official clocks start at acceptance
report_gap Compares present documents against the required checklist Checklist is sample data

Design notes

  • Zero dependencies. JSON-RPC 2.0 over stdin/stdout, implemented with the standard library only. No network calls at runtime; nothing leaves the machine.
  • Provenance in every answer. A tool that cannot say whether it answered from sample data or from your own data is a tool you cannot audit, so every result says which.
  • Mismatch is reported, not smoothed over. A UDI miss says "sample scope", a tree miss lists what trees exist, an empty lab match returns a hint rather than an empty success.

Gate

.github/workflows/ci.yml runs the unit tests and tools/version_gate.py, which checks version consistency across pyproject.toml, __init__.py, server.json and the declared tool count, and reports how many uses: references are pinned to full SHAs.


medxpert-ortho-mcp · 骨科器械检测对接连接器

先英后中。

一个 8 工具的 MCP server,用于骨科器械检测对接:机构匹配、报价估算、UDI 校验、双时态标准检索、 分类/路径判定树、地区路径、注册时间轴、缺口报告。离线、仅标准库、零依赖。

它存在的理由:四个 MedXpert 专家包(medxpert-standards、medical-device-reg-translator、 medical-device-testing-link、med-device-compliance-toolkit)从 2026 年起一直引用一个叫 medxpert-ortho-mcp 的连接器,而那个连接器从未被造出来。这就是它,现在有了。

哪些是真的,哪些是示例

方面 状态
服务本身、8 个工具、协议层 真的。 已实现、有单元测试、已发布到 PyPI 与官方 MCP Registry
datasets/ 里的数据 示例。 虚构机构、虚构价格、虚构 UDI-DI,仅供演示
每个工具返回值 只要没设 ORTHO_DATA_DIR,一律带 sample_data: true

包内数据不是资质目录、不是报价承诺、不是法规结论。要用于真实工作,把 ORTHO_DATA_DIR 指向你自己的 JSON 数据目录。

运行

uvx medxpert-ortho-mcp                        # 起 stdio MCP 服务
python -m medxpert_ortho.server --selftest   # 离线自测,不需要宿主

工具与诚实的边界

工具 做什么 边界
match_labs 按能力关键词、地区、器械描述给机构打分 示例数据仅 3 家机构、少数能力项
calc_quote 按机构与能力项给价格区间,超出含样量 +12% 价格为演示值,不构成商务报价
check_udi 14 位 UDI-DI 查表,回出分类/无菌/一次性 未命中会说明是示例范围,不是"不存在"的证据
query_standard 关键词检索 + as_of 双时态判定(是否生效、是否被替代) 状态字段为演示逻辑,以官方现行版为准
find_judgment_tree 逐步问答式分类/路径判定 演示结构,不是审评结论
get_region_path 受理机关、路径说明、必备材料 仅 CN / CN-JS / CN-SH 三条示例路径
check_timeline 相对天数展开成日历,标 completed / in_progress / not_started 与逾期 天数为示例;官方时限自受理起算
report_gap 已具备材料对照必备清单,报缺口与完整度 清单为示例数据

门禁

ci.yml 跑单元测试 + tools/version_gate.py:核对 pyproject.toml、__init__.py、server.json 与声明的工具数是否一致,并自报 uses: 有多少处钉了完整 SHA。

Metadata

Release files for medxpert-ortho-mcp 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for medxpert-ortho-mcp 0.1.1
File Size Uploaded Provenance Actions
medxpert_ortho_mcp-0.1.1.tar.gz 25.8 kB Without provenance Details for medxpert_ortho_mcp-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for medxpert-ortho-mcp 0.1.1
File Interpreter ABI Platform Actions
medxpert_ortho_mcp-0.1.1-py3-none-any.whl Python 3 none any Details for medxpert_ortho_mcp-0.1.1-py3-none-any.whl

Total release size: 50.4 kB

Release files / medxpert_ortho_mcp-0.1.1.tar.gz

Download URL medxpert_ortho_mcp-0.1.1.tar.gz
Size 25.8 kB
Tags Source
SHA-256 checksum
How to use checksums
39796b637294f39cfda293ba5f1f6c578c70e1397b48581fe423c953066169ae
BLAKE2b-256 checksum
How to use checksums
8893cce423a6c3366119afbb80dd58491ff9c3ba3cae288b604cd5a2e35c443c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / medxpert_ortho_mcp-0.1.1-py3-none-any.whl

Download URL medxpert_ortho_mcp-0.1.1-py3-none-any.whl
Size 24.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
57ca40e63886833a5123730909b5dcbc06c49fc24cf4b4cdf89f16bb1ff2c0f1
BLAKE2b-256 checksum
How to use checksums
44c8c4c4ac980c0127c2d43c898a14d2d8e59b54a7dc21896a47fa5db79338bf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for medxpert-ortho-mcp 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page