@ythalorossy/openfda 1.0.0

package/bin/OpenFDABuilder.js

@@ -0,0 +1,45 @@
+/**
+ * The OpenFDABuilder class helps construct URLs for the OpenFDA API.
+ *
+ * Usage:
+ *   - Set the context (such as 'label', 'ndc', or 'event') using the context() method.
+ *   - Set the search query using the search() method.
+ *   - Optionally set the result limit using the limit() method (default is 1).
+ *   - Call build() to assemble and return the final API URL.
+ *
+ * Example:
+ *   const url = new OpenFDABuilder()
+ *     .context('label')
+ *     .search('openfda.brand_name:"Advil"')
+ *     .limit(1)
+ *     .build();
+ *
+ * The build() method will throw an error if any required parameter is missing.
+ * The API key is read from the OPENFDA_API_KEY environment variable.
+ */
+export class OpenFDABuilder {
+    url = "https://api.fda.gov/drug/";
+    params = new Map();
+    context(context) {
+        this.params.set("context", context);
+        return this;
+    }
+    search(query) {
+        this.params.set("search", query);
+        return this;
+    }
+    limit(max = 1) {
+        this.params.set("limit", max);
+        return this;
+    }
+    build() {
+        const context = this.params.get("context");
+        const search = this.params.get("search");
+        const limit = this.params.get("limit");
+        const apiKey = process.env.OPENFDA_API_KEY;
+        if (!context || !search || !limit) {
+            throw new Error("Missing required parameters: context, search, or limit");
+        }
+        return `${this.url}${context}.json?api_key=${apiKey}&search=${search}&limit=${limit}`;
+    }
+}

package/bin/index.js

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import dotenv from "dotenv";
+import z from "zod";
+import { OpenFDABuilder } from "./OpenFDABuilder.js";
+dotenv.config();
+const USER_AGENT = "openfda-mcp/1.0";
+const server = new McpServer({
+    name: "openfda",
+    version: "1.0.0",
+    description: "OpenFDA Model Context Protocol",
+    capabilities: {
+        resources: {},
+        tools: {},
+    },
+});
+// Helper function for making OpenFDA API requests
+async function makeOpenFDARequest(url) {
+    const headers = {
+        "User-Agent": USER_AGENT,
+        Accept: "application/json",
+    };
+    try {
+        const response = await fetch(url, { headers });
+        if (!response.ok) {
+            throw new Error(`HTTP error! status: ${response.status}`);
+        }
+        return (await response.json());
+    }
+    catch (error) {
+        console.error("Error making NWS request:", error);
+        return null;
+    }
+}
+// Tool: get-drug-by-name
+// Description: Retrieves drug information from the OpenFDA API by brand name.
+// Input: drugName (string) - The brand name of the drug to search for.
+// Output: Returns key drug information fields such as brand name, generic name, manufacturer, NDC, product type, route, substance name, indications and usage, warnings, and other safety information.
+// Usage: Use this tool to look up detailed drug label data for a given brand name.
+server.tool("get-drug-by-name", "Get drug by name. Use this tool to get the drug information by name. The drug name should be the brand name. It returns the brand name, generic name, manufacturer name, product NDC, product type, route, substance name, indications and usage, warnings, do not use, ask doctor, ask doctor or pharmacist, stop use, pregnancy or breast feeding.", {
+    drugName: z.string().describe("Drug name"),
+}, async ({ drugName }) => {
+    const url = new OpenFDABuilder()
+        .context("label")
+        .search(`openfda.brand_name:"${drugName}"`)
+        .limit(1)
+        .build();
+    const drugData = await makeOpenFDARequest(url);
+    if (!drugData) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Failed to retrieve drug data for ${drugName}`,
+                },
+            ],
+        };
+    }
+    const drug = drugData.results.at(0);
+    const drugInfo = {
+        brand_name: drug?.openfda.brand_name,
+        generic_name: drug?.openfda.generic_name,
+        manufacturer_name: drug?.openfda.manufacturer_name,
+        product_ndc: drug?.openfda.product_ndc,
+        product_type: drug?.openfda.product_type,
+        route: drug?.openfda.route,
+        substance_name: drug?.openfda.substance_name,
+        indications_and_usage: drug?.indications_and_usage,
+        warnings: drug?.warnings,
+        do_not_use: drug?.do_not_use,
+        ask_doctor: drug?.ask_doctor,
+        ask_doctor_or_pharmacist: drug?.ask_doctor_or_pharmacist,
+        stop_use: drug?.stop_use,
+        pregnancy_or_breast_feeding: drug?.pregnancy_or_breast_feeding,
+    };
+    return {
+        content: [
+            {
+                type: "text",
+                text: `drug: ${JSON.stringify(drugInfo)}`,
+            },
+        ],
+    };
+});
+// The above code registers a tool named "get-drug-by-name" with the MCP server.
+// This tool allows users to retrieve detailed drug label information from the OpenFDA API
+// by providing a brand name. It constructs the appropriate API request, fetches the data,
+// and returns key drug information fields in a structured text response.
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("OpenFDA MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error in main():", error);
+    process.exit(1);
+});

package/bin/types.js

@@ -0,0 +1 @@
+export {};

package/build/OpenFDABuilder.js

@@ -0,0 +1,45 @@
+/**
+ * The OpenFDABuilder class helps construct URLs for the OpenFDA API.
+ *
+ * Usage:
+ *   - Set the context (such as 'label', 'ndc', or 'event') using the context() method.
+ *   - Set the search query using the search() method.
+ *   - Optionally set the result limit using the limit() method (default is 1).
+ *   - Call build() to assemble and return the final API URL.
+ *
+ * Example:
+ *   const url = new OpenFDABuilder()
+ *     .context('label')
+ *     .search('openfda.brand_name:"Advil"')
+ *     .limit(1)
+ *     .build();
+ *
+ * The build() method will throw an error if any required parameter is missing.
+ * The API key is read from the OPENFDA_API_KEY environment variable.
+ */
+export class OpenFDABuilder {
+    url = "https://api.fda.gov/drug/";
+    params = new Map();
+    context(context) {
+        this.params.set("context", context);
+        return this;
+    }
+    search(query) {
+        this.params.set("search", query);
+        return this;
+    }
+    limit(max = 1) {
+        this.params.set("limit", max);
+        return this;
+    }
+    build() {
+        const context = this.params.get("context");
+        const search = this.params.get("search");
+        const limit = this.params.get("limit");
+        const apiKey = process.env.OPENFDA_API_KEY;
+        if (!context || !search || !limit) {
+            throw new Error("Missing required parameters: context, search, or limit");
+        }
+        return `${this.url}${context}.json?api_key=${apiKey}&search=${search}&limit=${limit}`;
+    }
+}

package/build/index.js

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import dotenv from "dotenv";
+import z from "zod";
+import { OpenFDABuilder } from "./OpenFDABuilder.js";
+dotenv.config();
+const USER_AGENT = "openfda-mcp/1.0";
+const server = new McpServer({
+    name: "openfda",
+    version: "1.0.0",
+    description: "OpenFDA Model Context Protocol",
+    capabilities: {
+        resources: {},
+        tools: {},
+    },
+});
+// Helper function for making OpenFDA API requests
+async function makeOpenFDARequest(url) {
+    const headers = {
+        "User-Agent": USER_AGENT,
+        Accept: "application/json",
+    };
+    try {
+        const response = await fetch(url, { headers });
+        if (!response.ok) {
+            throw new Error(`HTTP error! status: ${response.status}`);
+        }
+        return (await response.json());
+    }
+    catch (error) {
+        console.error("Error making NWS request:", error);
+        return null;
+    }
+}
+// Tool: get-drug-by-name
+// Description: Retrieves drug information from the OpenFDA API by brand name.
+// Input: drugName (string) - The brand name of the drug to search for.
+// Output: Returns key drug information fields such as brand name, generic name, manufacturer, NDC, product type, route, substance name, indications and usage, warnings, and other safety information.
+// Usage: Use this tool to look up detailed drug label data for a given brand name.
+server.tool("get-drug-by-name", "Get drug by name. Use this tool to get the drug information by name. The drug name should be the brand name. It returns the brand name, generic name, manufacturer name, product NDC, product type, route, substance name, indications and usage, warnings, do not use, ask doctor, ask doctor or pharmacist, stop use, pregnancy or breast feeding.", {
+    drugName: z.string().describe("Drug name"),
+}, async ({ drugName }) => {
+    const url = new OpenFDABuilder()
+        .context("label")
+        .search(`openfda.brand_name:"${drugName}"`)
+        .limit(1)
+        .build();
+    const drugData = await makeOpenFDARequest(url);
+    if (!drugData) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Failed to retrieve drug data for ${drugName}`,
+                },
+            ],
+        };
+    }
+    const drug = drugData.results.at(0);
+    const drugInfo = {
+        brand_name: drug?.openfda.brand_name,
+        generic_name: drug?.openfda.generic_name,
+        manufacturer_name: drug?.openfda.manufacturer_name,
+        product_ndc: drug?.openfda.product_ndc,
+        product_type: drug?.openfda.product_type,
+        route: drug?.openfda.route,
+        substance_name: drug?.openfda.substance_name,
+        indications_and_usage: drug?.indications_and_usage,
+        warnings: drug?.warnings,
+        do_not_use: drug?.do_not_use,
+        ask_doctor: drug?.ask_doctor,
+        ask_doctor_or_pharmacist: drug?.ask_doctor_or_pharmacist,
+        stop_use: drug?.stop_use,
+        pregnancy_or_breast_feeding: drug?.pregnancy_or_breast_feeding,
+    };
+    return {
+        content: [
+            {
+                type: "text",
+                text: `drug: ${JSON.stringify(drugInfo)}`,
+            },
+        ],
+    };
+});
+// The above code registers a tool named "get-drug-by-name" with the MCP server.
+// This tool allows users to retrieve detailed drug label information from the OpenFDA API
+// by providing a brand name. It constructs the appropriate API request, fetches the data,
+// and returns key drug information fields in a structured text response.
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("OpenFDA MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error in main():", error);
+    process.exit(1);
+});

package/build/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@ythalorossy/openfda",
+  "version": "1.0.0",
+  "description": "OpenFDA Model Context Protocol",
+  "bin": {
+    "openfda": "./bin/index.js"
+  },
+  "main": "index.js",
+  "scripts": {
+    "build": "tsc && chmod 755 build/index.js",
+    "build:cli": "npm run build && node scripts/add-shebang.cjs && shx cp -r build/* bin/",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "Ythalo Saldanha",
+  "license": "ISC",
+  "type": "module",
+  "files": [
+    "build",
+    "bin"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.15.1",
+    "dotenv": "^17.2.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.14",
+    "typescript": "^5.8.3",
+    "shx": "^0.3.4"
+  }
+}