ortho-mcp — Orthopedic Device Testing MCP Server

Expose the orthopedic device testing workflow as MCP tools: device → test items → lab matching → quote → subcontracting → UDI check → regulatory deadlines. Zero network egress, zero npm dependencies, runnable with plain Node.

v1.3.0 · MCP stdio server · JSON-RPC 2.0 · Node ≥ 18

Quick start (via npx)

{
  "mcpServers": {
    "ortho-mcp": {
      "command": "npx",
      "args": ["-y", "ortho-mcp"]
    }
  }
}

Manual run:

npx -y ortho-mcp
# or from source: node ortho_mcp_server.js

Tools (15)

| Tool | What it does | |---|---| | match_labs | Device / standard → lab shortlist (qualification state, coverage, quote, A+B subcontract) | | calc_quote | Quote & lead time for a given lab (est. price = base × price factor; mgmt fee 8%; rush factor; critical-path lead time) | | find_subcontract | A+B subcontract solver (auto-pick or explicit primary lab; uncovered items; downgrade judgment) | | list_devices | Orthopedic device catalog (18 categories; keyword filter; extra test items preview) | | list_standards | Standards library search (43 entries; keyword/category filter; sample size, base price, current status) | | get_lab | Lab detail (CMA/CNAS qualification states, health score, freeze state, price factor, coverage) | | check_udi | UDI validation & parsing (GS1 check digit 8/12/13/14; AI bracket format + FNC1 raw format) | | list_deadlines | Regulatory deadlines (GMP 2025 notice #107 effective 2026-11-01; EU MDR/IVDR transition; red ≤90d / yellow ≤180d) | | query_standard | Standards knowledge query (92 docs / 64 standards index) | | find_judgment_tree | Judgment / decision-tree lookup for a standard | | get_region_path | Registration path by region / product | | check_timeline | Bi-temporal timeline check (standards evolution) | | report_gap | Gap report against a target standard set | | evolve_status | Evolution health status of the knowledge base | | reindex | Rebuild the standards index |

Architecture

┌─────────────────────────┐     ┌──────────────────────────────┐
│  HTML platform (human)   │     │  MCP stdio (AI)              │
└────────────┬────────────┘     │  ortho_mcp_server.js         │
             │   shared extraction layer                       │
             └──────────► ortho-core.js ◄──────────┘
                  (generated from the HTML platform)

Data is maintained in one source (the HTML platform), then re-extracted into ortho-core.js; the MCP side stays zero-maintenance.

Data disclaimer

Lab dataset (20 labs), standards library (43 entries) and device catalog (18 categories) are demonstration data. Results are for demo / pipeline validation until real qualification data is loaded. Replacing the data section and re-extracting is enough to go live; no MCP-side code change is needed.

Test

npm test            # core (40) + server e2e (19, incl. error paths)

Files

| File | Description | |---|---| | ortho_mcp_server.js | MCP stdio server (hand-written JSON-RPC 2.0, zero deps) | | ortho-core.js | Core logic layer (extracted from the HTML platform, do not hand-edit) | | ortho-standards-tools.js | Standards / knowledge-base module | | ortho-data.json / kb-standards.js | Demo datasets | | test_core.js / test_server.py | Regression tests |

License & authorship

License: MIT (see LICENSE). Maintained as part of the MedXpert regulatory toolchain. Co-created by human and AI.