Skip to content

v0.1.0: Offline US medical code lookup and crosswalk

Choose a tag to compare

View all tags
@cyanheads cyanheads released this 13 Jun 18:16
· 9 commits to main since this release
v0.1.0
This tag was signed with the committer’s verified signature.
cyanheads Casey Hand
SSH Key Fingerprint: lkZCAfVCK5qsrcvEYCs0BnVRDCX7pKsdCZkw5yYKMuw
Verified
Learn about vigilant mode.
a3fa798
This commit was signed with the committer’s verified signature.
cyanheads Casey Hand
SSH Key Fingerprint: lkZCAfVCK5qsrcvEYCs0BnVRDCX7pKsdCZkw5yYKMuw
Verified
Learn about vigilant mode.

Offline US medical code lookup and crosswalk

Initial release. Indexes the freely-redistributable US federal code sets into one offline, keyless, deterministic MCP server backed by a bundled SQLite + FTS5 database built at package-build time.

Added:

  • Six read-only medcode_* tools: get_code (batch decode, auto-detect, partial-success), search_codes (FTS5 description search, truncation disclosure), check_code (discriminated validity status with whyNot), map_codes (parents/children crosswalk), browse_hierarchy (prefix for CM/HCPCS, axis-based for PCS), list_systems (release provenance).
  • Bundled systems: ICD-10-CM, ICD-10-PCS, HCPCS Level II. RxNorm drug crosswalks land in a later release (drug directions raise direction_unavailable until then).
  • code-index service opens the bundled DB read-only at startup (bun:sqlite under Bun, better-sqlite3 under Node); fails fast on a missing or empty index.
  • Server config: MEDCODE_DB_PATH, MEDCODE_MAX_RESULTS (default 50, ceiling 200).

56 tests pass; bun run devcheck clean.

Assets 3
Loading