@cyanheads/pubmed-mcp-server
Version:
A Model Context Protocol (MCP) server enabling AI agents to intelligently search, retrieve, and analyze biomedical literature from PubMed via NCBI E-utilities. Built on the mcp-ts-template for robust, production-ready performance.
77 lines (76 loc) • 3.2 kB
JavaScript
/**
* @fileoverview Generic helper functions for parsing XML data, particularly
* structures from fast-xml-parser.
* @module src/utils/parsing/ncbi-parsing/xmlGenericHelpers
*/
/**
* Ensures that the input is an array. If it's not an array, it wraps it in one.
* Handles undefined or null by returning an empty array.
* @param item - The item to ensure is an array.
* @returns An array containing the item, or an empty array if item is null/undefined.
* @template T - The type of the items in the array.
*/
export function ensureArray(item) {
if (item === undefined || item === null) {
return [];
}
return Array.isArray(item) ? item : [item];
}
/**
* Safely extracts text content from an XML element, which might be a string or an object with a "#text" property.
* Handles cases where #text might be a number or boolean by converting to string.
* @param element - The XML element (string, object with #text, or undefined).
* @param defaultValue - The value to return if text cannot be extracted. Defaults to an empty string.
* @returns The text content or the default value.
*/
export function getText(element, defaultValue = "") {
if (element === undefined || element === null) {
return defaultValue;
}
if (typeof element === "string") {
return element;
}
if (typeof element === "number" || typeof element === "boolean") {
return String(element); // Handle direct number/boolean elements
}
if (typeof element === "object" && element["#text"] !== undefined) {
// Check if #text exists and convert to string
if (typeof element["#text"] === "string") {
return element["#text"];
}
// Also handle #text being a number or boolean
if (typeof element["#text"] === "number" ||
typeof element["#text"] === "boolean") {
return String(element["#text"]);
}
}
return defaultValue;
}
/**
* Safely extracts an attribute value from an XML element.
* Assumes attributes are prefixed with "@_" by fast-xml-parser.
* @param element - The XML element object.
* @param attributeName - The name of the attribute (e.g., "_UI", "_MajorTopicYN", without the "@_" prefix).
* @param defaultValue - The value to return if the attribute is not found. Defaults to an empty string.
* @returns The attribute value or the default value.
*/
export function getAttribute(element, attributeName, // e.g., "UI", "MajorTopicYN"
defaultValue = "") {
const fullAttributeName = `@_${attributeName}`; // As per fast-xml-parser config
if (element &&
typeof element === "object" &&
typeof element[fullAttributeName] === "string") {
return element[fullAttributeName];
}
if (element &&
typeof element === "object" &&
typeof element[fullAttributeName] === "boolean") {
return String(element[fullAttributeName]); // Convert boolean attributes to string
}
if (element &&
typeof element === "object" &&
typeof element[fullAttributeName] === "number") {
return String(element[fullAttributeName]); // Convert number attributes to string
}
return defaultValue;
}