RxNorm — 표준화된 의약품 개념

National Library of Medicine의 표준화된 의약품 명명법입니다. 미국 의료 시스템의 모든 처방약, 일반의약품, 성분에는 RxCUI(안정적인 개념 ID)가 있습니다. RxNorm은 의약품 명명의 혼란을 정규화합니다. "Tylenol", "acetaminophen", "APAP"는 모두 동일한 성분 개념으로 연결됩니다. 무료이며 인증이 필요 없습니다.

Pipeworx의 일부입니다 — AI 에이전트를 1476개 이상의 실시간 데이터 소스에 연결하는 MCP 게이트웨이입니다.

AI 에이전트에게 중요한 이유

의약품 데이터는 악명 높을 정도로 지저분합니다. 브랜드명, 일반명, 염 형태, 용량 강도, 제형 — 같은 분자에 수십 개의 문자열이 존재합니다. RxNorm은 FDA 데이터, 약물 상호작용 데이터베이스, EHR 시스템, 임상 시험을 상호 참조하는 데 사용할 수 있는 표준 ID를 제공합니다.

세 가지 핵심 흐름:

1. 이름 해석. "Ozempic이 뭔가요?" → rxnorm_search({name: "ozempic"}) → 용어 유형(SBD, BN, IN 등)별 개념 그룹과 RxCUI를 반환합니다.

2. 의약품 속성 조회. "이 RxCUI는 무엇인가요?" → rxnorm_get_properties({rxcui}) → 성분명, 함량, 제형, 브랜드 여부.

3. 약물 상호작용 — 사용 불가. NLM은 2024년 1월 RxNav 상호작용 API를 중단했고 이를 대체한 것은 없습니다. 따라서 이 팩에는 rxnorm_interactions 도구가 없으며 Pipeworx에도 약물-약물 상호작용 소스가 없습니다. pharma_safety_report는 FDA 라벨의 Drug Interactions 섹션을 반환하는데, 이는 약물 쌍을 확인하는 대신 단일 약물에 대한 정보를 문서화한 것입니다. 해당 텍스트에 없는 약물은 안전성이 확인된 것이 아닙니다.

RxNorm + FDA + ClinicalTrials를 결합한 완전한 의약품 안전성 종합 분석을 위해서는 [compare_entities({type: "drug", values})] 또는 pharma_drug_profile 복합 도구를 사용하세요.

Related MCP server: MedData MCP Server

용어 유형(TTY) — 이해해야 할 중요 사항

RxNorm은 각 약물에 대해 서로 다른 추상화 수준의 여러 개념을 가집니다:

교차 소스 연결을 위해서는 IN(성분) RxCUI가 존재하는 경우 항상 이를 우선하세요. 국가별 브랜드 의약품은 SBD가 다를 수 있지만 IN은 전 세계적으로 동일합니다. resolve_entity({type: "drug"})는 우선순위 IN > PIN > BN > SBD > 첫 번째 사용 가능 항목 순으로 표준 RxCUI를 선택합니다.

인용 가능한 URI

pipeworx://rxnorm/concept/{rxcui}
pipeworx://rxnorm/concept/{rxcui}/interactions

RxCUI는 안정적이고 공유할 수 있습니다.

업데이트 주기

RxNorm은 매월 업데이트를 게시합니다. 신약은 FDA 승인 후 한 달 이내에 나타나며, 비권장 제품은 표시되지만 기록 조회를 위해 데이터베이스에 유지됩니다. Pipeworx는 24시간 TTL로 캐시합니다.

자주 겪는 문제점

• 브랜드 검색 시 SBD만 반환됩니다. "Ozempic"을 검색하면 성분이 아닌 Semantic Branded Drug 개념이 반환됩니다. "semaglutide"까지 가려면 일반명을 직접 검색하거나 브랜드 RxCUI에 rxnorm_related({rxcui, tty: "IN"})를 호출하세요. 후자는 일부 구성에서 현재 버그가 있습니다 — 오류 복구 참조.

• 철자가 생각보다 중요합니다. "metformin hydrochloride"와 "metformin HCl"은 약간 다른 개념 집합을 반환합니다. 검색은 일반적인 약어에는 유연하지만 덜 일반적인 약어에는 정확합니다.

• NDC는 다릅니다. National Drug Code(NDC)는 RxCUI가 아니라 FDA가 발급하는 패키지 수준 식별자입니다. 처방 조제 데이터에 NDC가 필요하다면 rxnorm_ndc({rxcui})를 사용하여 연결하세요.

• 복합 제품. "Kombiglyze"와 같은 약물은 metformin + saxagliptin을 포함합니다. "metformin"을 검색하면 복합 제품이 상위 결과로 표시될 수 있으며, 이는 성분 수준 분석에 원하는 결과가 아닙니다. 첫 번째 결과를 그냥 선택하지 말고 SCD 또는 IN으로 필터링하세요.

• 판매 중단 의약품. 약물이 철수된 후에도 개념은 유지됩니다. 전체 레코드의 obsolete 플래그는 해당 약물이 현재 사용 가능한지 알려줍니다.

빠른 시작

MCP 클라이언트(Claude Desktop, Cursor, Windsurf 등)에 추가하세요:

{
  "mcpServers": {
    "rxnorm": {
      "url": "https://gateway.pipeworx.io/rxnorm/mcp"
    }
  }
}

이 엔드포인트가 실제로 제공하는 것

https://gateway.pipeworx.io/rxnorm/mcp의 tools/list는 위 표의 도구에 공용 Pipeworx 메타 도구를 더한 것을 반환합니다 — ask_pipeworx, discover_tools, search_within, remember/recall 및 게이트웨이 전체 세트의 나머지 도구들입니다. 따라서 표시되는 도구 수는 이 표보다 많습니다. 단일 팩 엔드포인트는 현재 자체 도구와 함께 약 30개의 공용 도구를 나열합니다. 연결의 initialize 응답은 정확한 범위를 명시하며 특정 시점의 권위 있는 답변입니다.

이는 의도적인 것이지 우연한 멀티플렉싱이 아닙니다. 메타 도구는 범위가 제한된 연결이 이 팩이 다루지 않는 질문에 답할 수 있게 해주는 것입니다 — 전체 카탈로그에 걸쳐 라우팅하는 ask_pipeworx를 통해서 — MCP 서버를 추가로 연결하지 않고도 말이죠. 현재 메타 도구 없이 팩 엔드포인트를 마운트할 방법은 없습니다. 추가 스키마가 라우팅 가치보다 더 많은 컨텍스트를 소모한다면 여러 팩 엔드포인트 대신 전체 게이트웨이에 한 번 연결하세요.

또는 전체 Pipeworx 게이트웨이에 연결하여 이 팩의 도구뿐만 아니라 모든 팩의 도구를 직접 나열할 수 있습니다:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

두 URL 모두 동일한 게이트웨이와 동일한 1476개 이상의 데이터 소스에 도달합니다. 유일한 차이점은 어떤 팩의 도구가 직접 나열되는지입니다. ask_pipeworx는 어느 쪽에서든 모든 도구에 도달할 수 있습니다.

ask_pipeworx와 함께 사용하기

도구를 직접 호출하는 대신 일반 영어로 질문할 수 있습니다. 이는 위의 팩 엔드포인트와 전체 게이트웨이에서 모두 작동합니다:

ask_pipeworx({ question: "your question about Rxnorm data" })

게이트웨이가 적절한 도구를 선택하고 인수를 자동으로 채웁니다.

더 보기

• 문서 및 가이드

• pipeworx.io

라이선스

MIT