RxNorm — Standardisierte Arzneimittelkonzepte

Die standardisierte Arzneimittelnomenklatur der National Library of Medicine. Jedes Rezept, jedes rezeptfreie Medikament und jeder Wirkstoff im US-Gesundheitssystem hat eine RxCUI (eine stabile Konzept-ID). RxNorm normalisiert das Chaos bei der Arzneimittelbenennung: „Tylenol", „Acetaminophen" und „APAP" führen alle zum selben Wirkstoffkonzept. Kostenlos, keine Authentifizierung.

Teil von Pipeworx – ein MCP-Gateway, das KI-Agenten mit über 1476+ Live-Datenquellen verbindet.

Warum das für KI-Agenten wichtig ist

Arzneimitteldaten sind bekanntermaßen unübersichtlich. Markennamen, generische Namen, Salzformen, Dosierungsstärken, Darreichungsformen – dasselbe Molekül, Dutzende von Zeichenfolgen. RxNorm liefert kanonische IDs, mit denen Sie FDA-Daten, Wechselwirkungsdatenbanken, EHR-Systeme und klinische Studien abgleichen können.

Drei Kernabläufe:

1. Einen Namen auflösen. „Was ist Ozempic?" → rxnorm_search({name: "ozempic"}) → Konzeptgruppen nach Begriffstyp (SBD, BN, IN usw.) mit RxCUIs.

2. Arzneimitteleigenschaften abrufen. „Was ist diese RxCUI?" → rxnorm_get_properties({rxcui}) → Wirkstoffname, Stärke, Darreichungsform, Markenstatus.

3. Wechselwirkungen – nicht verfügbar. Die NLM hat die RxNav-Interaktions-API im Januar 2024 eingestellt und nichts hat sie ersetzt. Daher verfügt dieses Paket über kein rxnorm_interactions-Tool und Pipeworx hat keine Quelle für Arzneimittel-Wechselwirkungen. pharma_safety_report gibt den Abschnitt „Wechselwirkungen" des FDA-Labels selbst zurück, der ein einzelnes Medikament dokumentiert und nicht ein Paar prüft; ein Medikament, das in diesem Text fehlt, ist nicht freigegeben.

Für eine vollständige Arzneimittelsicherheits-Synthese, die RxNorm + FDA + ClinicalTrials kombiniert, verwenden Sie [compare_entities({type: "drug", values})] oder das pharma_drug_profile-Verbundwerkzeug.

Related MCP server: MedData MCP Server

Begriffstypen (TTYs) – wichtig zu verstehen

RxNorm hat mehrere Konzepte pro Medikament, jeweils auf unterschiedlichen Abstraktionsebenen:

Für die Verknüpfung über Quellen hinweg bevorzugen Sie immer die IN (Wirkstoff)-RxCUI, wenn eine existiert. Markenarzneimittel haben in verschiedenen Ländern unterschiedliche SBDs; die IN ist global. resolve_entity({type: "drug"}) wählt die kanonische RxCUI in der Prioritätsreihenfolge IN > PIN > BN > SBD > erste verfügbare.

Zitierbare URIs

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

RxCUIs sind stabil und teilbar.

Aktualisierungsrhythmus

RxNorm veröffentlicht monatliche Updates. Neue Medikamente erscheinen innerhalb eines Monats nach der FDA-Zulassung; veraltete Produkte werden gekennzeichnet, aber für historische Nachschlagezwecke in der Datenbank behalten. Pipeworx speichert mit einer 24-Stunden-TTL zwischen.

Häufige Fallstricke

• Die Suche liefert für Markenanfragen nur SBD. Die Suche nach „Ozempic" liefert semantische Markenarzneimittel-Konzepte, nicht den Wirkstoff. Um zu „semaglutide" zu gelangen, suchen Sie entweder direkt nach dem generischen Namen oder rufen Sie rxnorm_related({rxcui, tty: "IN"}) für eine Marken-RxCUI auf. Letzteres hat derzeit in einigen Konfigurationen Fehler – siehe Fehlerbehebung.

• Die Schreibweise ist wichtiger, als man denkt. „metformin hydrochloride" und „metformin HCl" liefern leicht unterschiedliche Konzeptmengen. Die Suche ist bei gebräuchlichen Abkürzungen nachsichtig, bei weniger gebräuchlichen jedoch exakt.

• NDCs sind anders. National Drug Codes (NDCs) sind von der FDA ausgegebene Kennungen auf Packungsebene, keine RxCUIs. Verwenden Sie rxnorm_ndc({rxcui}), um zu überbrücken, wenn Sie NDC für Verschreibungsdaten benötigen.

• Kombinationsprodukte. Ein Medikament wie „Kombiglyze" enthält Metformin + Saxagliptin. Die Suche nach „Metformin" kann Kombinationsprodukte als obersten Treffer anzeigen, was für eine Analyse auf Wirkstoffebene nicht gewünscht ist. Filtern Sie nach SCD oder IN, statt einfach das erste Ergebnis zu nehmen.

• Eingestellte Medikamente. Konzepte bleiben bestehen, nachdem ein Medikament vom Markt genommen wurde. Das obsolete-Flag im vollständigen Datensatz zeigt Ihnen, ob das Medikament derzeit verfügbar ist.

Schnellstart

Fügen Sie zu Ihrem MCP-Client hinzu (Claude Desktop, Cursor, Windsurf usw.):

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

Was dieser Endpunkt tatsächlich bereitstellt

tools/list unter https://gateway.pipeworx.io/rxnorm/mcp gibt die Tools in der obigen Tabelle zurück plus die gemeinsamen Pipeworx-Meta-Tools – ask_pipeworx, discover_tools, search_within, remember/recall und den Rest des Gateway-weiten Satzes. Die angezeigte Tool-Anzahl ist also größer als diese Tabelle: Ein Einzelpaket-Endpunkt listet derzeit etwa 30 gemeinsame Tools neben den eigenen des Pakets auf. Die initialize-Antwort der Verbindung gibt den genauen Umfang an und ist die maßgebliche Antwort für einen bestimmten Tag.

Das ist beabsichtigt, kein versehentliches Multiplexing. Die Meta-Tools ermöglichen es einer eingeschränkten Verbindung, eine Frage zu beantworten, die dieses Paket nicht abdeckt – über ask_pipeworx, das über den gesamten Katalog weiterleitet – ohne dass Sie einen zweiten MCP-Server hinzufügen müssen. Es gibt derzeit keine Möglichkeit, einen Paket-Endpunkt ohne sie zu mounten; wenn die zusätzlichen Schemas mehr Kontext kosten, als das Routing wert ist, verbinden Sie sich einmal mit dem vollständigen Gateway, anstatt mit mehreren Paket-Endpunkten.

Oder verbinden Sie sich mit dem vollständigen Pipeworx-Gateway, um die Tools jedes Pakets direkt aufgelistet zu bekommen, anstatt nur die dieses Pakets:

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

Beide URLs erreichen dasselbe Gateway und dieselben 1476+ Datenquellen. Der einzige Unterschied besteht darin, welche Tools des Pakets direkt aufgelistet sind; ask_pipeworx erreicht alle von beiden aus.

Verwendung mit ask_pipeworx

Anstatt Tools direkt aufzurufen, können Sie Fragen in einfachem Englisch stellen – das funktioniert sowohl auf dem obigen Paket-Endpunkt als auch auf dem vollständigen Gateway:

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

Das Gateway wählt das richtige Tool aus und füllt die Argumente automatisch aus.

Weitere Informationen

• Dokumentation und Anleitungen

• pipeworx.io

Lizenz

MIT