@nucl-parquet/mcp 0.13.2

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+interface Library {
+    name: string;
+    description: string;
+    source_url: string;
+    projectiles: string[];
+    data_type: string;
+    version: string;
+    path: string;
+}
+interface Catalog {
+    libraries: Record<string, Library>;
+    shared: {
+        meta: {
+            path: string;
+            files: Record<string, string>;
+        };
+        stopping: {
+            path: string;
+            files: Record<string, string>;
+            sources: string[];
+        };
+    };
+}
+declare function fetchParquetRows(relativePath: string, baseUrl?: string): Promise<Record<string, unknown>[]>;
+declare function getCatalog(): Catalog;
+
+export { fetchParquetRows, getCatalog };

package/dist/index.js

@@ -0,0 +1,237 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { parquetRead } from "hyparquet";
+import { compressors } from "hyparquet-compressors";
+import { z } from "zod";
+var BASE_URL = process.env.NUCL_PARQUET_BASE_URL ?? "https://raw.githubusercontent.com/exoma-ch/nucl-parquet/main/data/";
+var CATALOG = {
+  libraries: {
+    "tendl-2024": { name: "TENDL-2024", description: "TALYS Evaluated Nuclear Data Library 2024 (IAEA/PSI)", source_url: "https://tendl.web.psi.ch/tendl_2024/tendl2024.html", projectiles: ["p", "d", "t", "h", "a"], data_type: "cross_sections", version: "2024", path: "tendl-2024/xs/" },
+    "endfb-8.1": { name: "ENDF/B-VIII.1", description: "US Evaluated Nuclear Data File (NNDC/BNL)", source_url: "https://www.nndc.bnl.gov/endf-b8.1/", projectiles: ["n", "p", "d", "t", "h", "a"], data_type: "cross_sections", version: "VIII.1", path: "endfb-8.1/xs/" },
+    "jeff-4.0": { name: "JEFF-4.0", description: "Joint Evaluated Fission and Fusion File (NEA)", source_url: "https://www.oecd-nea.org/dbdata/jeff/", projectiles: ["n", "p"], data_type: "cross_sections", version: "4.0", path: "jeff-4.0/xs/" },
+    "jendl-5": { name: "JENDL-5", description: "Japanese Evaluated Nuclear Data Library (JAEA)", source_url: "https://wwwndc.jaea.go.jp/jendl/j5/j5.html", projectiles: ["n", "p", "d", "a"], data_type: "cross_sections", version: "5", path: "jendl-5/xs/" },
+    "tendl-2025": { name: "TENDL-2025", description: "TALYS Evaluated Nuclear Data Library 2025 (PSI)", source_url: "https://tendl.web.psi.ch/", projectiles: ["n", "p", "d", "t", "h", "a"], data_type: "cross_sections", version: "2025", path: "tendl-2025/xs/" },
+    "cendl-3.2": { name: "CENDL-3.2", description: "Chinese Evaluated Nuclear Data Library (CIAE)", source_url: "http://www.nuclear.csdb.cn/", projectiles: ["n"], data_type: "cross_sections", version: "3.2", path: "cendl-3.2/xs/" },
+    "brond-3.1": { name: "BROND-3.1", description: "Russian Evaluated Nuclear Data Library (IPPE)", source_url: "https://vant.ippe.ru/", projectiles: ["n"], data_type: "cross_sections", version: "3.1", path: "brond-3.1/xs/" },
+    "fendl-3.2": { name: "FENDL-3.2", description: "Fusion Evaluated Nuclear Data Library (IAEA)", source_url: "https://www-nds.iaea.org/fendl/", projectiles: ["n"], data_type: "cross_sections", version: "3.2", path: "fendl-3.2/xs/" },
+    "eaf-2010": { name: "EAF-2010", description: "European Activation File (CCFE)", source_url: "https://fispact.ukaea.uk/", projectiles: ["n"], data_type: "cross_sections", version: "2010", path: "eaf-2010/xs/" },
+    "irdff-2": { name: "IRDFF-II", description: "International Reactor Dosimetry and Fusion File (IAEA)", source_url: "https://www-nds.iaea.org/IRDFF/", projectiles: ["n"], data_type: "cross_sections", version: "II", path: "irdff-2/xs/" },
+    "iaea-medical": { name: "IAEA-Medical", description: "Medical isotope production cross-sections (IAEA)", source_url: "https://www-nds.iaea.org/medical/", projectiles: ["p", "d", "h", "a"], data_type: "cross_sections", version: "latest", path: "iaea-medical/xs/" },
+    "jendl-ad-2017": { name: "JENDL/AD-2017", description: "Activation/Dosimetry Library (JAEA)", source_url: "https://wwwndc.jaea.go.jp/jendl/jad/jad.html", projectiles: ["n", "p"], data_type: "cross_sections", version: "2017", path: "jendl-ad-2017/xs/" },
+    "jendl-deu-2020": { name: "JENDL-DEU-2020", description: "Dedicated deuteron-induced reaction library (JAEA)", source_url: "https://wwwndc.jaea.go.jp/jendl/deu/deu.html", projectiles: ["d"], data_type: "cross_sections", version: "2020", path: "jendl-deu-2020/xs/" },
+    "iaea-pd-2019": { name: "IAEA-PD-2019", description: "Photonuclear Data Library (IAEA)", source_url: "https://www-nds.iaea.org/photonuclear/", projectiles: ["g"], data_type: "cross_sections", version: "2019", path: "iaea-pd-2019/xs/" },
+    "exfor": { name: "EXFOR", description: "Experimental nuclear reaction data (IAEA NDS)", source_url: "https://www-nds.iaea.org/exfor/", projectiles: ["n", "p", "d", "t", "h", "a"], data_type: "experimental_cross_sections", version: "latest", path: "exfor/" }
+  },
+  shared: {
+    meta: { path: "meta/", files: { abundances: "abundances.parquet", decay: "decay.parquet", elements: "elements.parquet" } },
+    stopping: {
+      path: "stopping/",
+      files: {
+        PSTAR: "PSTAR.parquet",
+        ASTAR: "ASTAR.parquet",
+        ESTAR: "ESTAR.parquet",
+        dSTAR: "dSTAR.parquet",
+        tSTAR: "tSTAR.parquet",
+        catima: "catima/catima.parquet"
+      },
+      sources: ["PSTAR", "ASTAR", "ESTAR", "dSTAR", "tSTAR", "catima"]
+    }
+  }
+};
+var parquetCache = /* @__PURE__ */ new Map();
+async function fetchParquetRows(relativePath, baseUrl = BASE_URL) {
+  if (parquetCache.has(relativePath)) return parquetCache.get(relativePath);
+  const url = new URL(relativePath, baseUrl).href;
+  const resp = await fetch(url);
+  if (!resp.ok) throw new Error(`HTTP ${resp.status} fetching ${url}`);
+  const buffer = await resp.arrayBuffer();
+  const rows = [];
+  await parquetRead({
+    file: buffer,
+    compressors,
+    rowFormat: "object",
+    onComplete: (data) => {
+      rows.push(...data);
+    }
+  });
+  parquetCache.set(relativePath, rows);
+  return rows;
+}
+async function fetchManifest(libraryId) {
+  const lib = CATALOG.libraries[libraryId];
+  if (!lib) throw new Error(`Unknown library: ${libraryId}`);
+  const manifestPath = lib.path.replace(/xs\/$/, "manifest.json");
+  const url = new URL(manifestPath, BASE_URL).href;
+  const resp = await fetch(url);
+  if (!resp.ok) throw new Error(`HTTP ${resp.status} fetching manifest for ${libraryId}`);
+  return await resp.json();
+}
+function getCatalog() {
+  return CATALOG;
+}
+function truncateRows(rows, limit) {
+  if (rows.length <= limit) return { rows, truncated: false, total: rows.length };
+  return { rows: rows.slice(0, limit), truncated: true, total: rows.length };
+}
+var server = new McpServer({
+  name: "nucl-parquet",
+  version: "0.3.7"
+});
+server.tool(
+  "list_libraries",
+  "List all available nuclear data libraries with projectiles and descriptions",
+  {},
+  async () => {
+    const libs = Object.entries(CATALOG.libraries).map(([id, lib]) => ({
+      id,
+      name: lib.name,
+      description: lib.description,
+      projectiles: lib.projectiles,
+      version: lib.version,
+      data_type: lib.data_type
+    }));
+    return { content: [{ type: "text", text: JSON.stringify(libs, null, 2) }] };
+  }
+);
+server.tool(
+  "list_isotopes",
+  "List available target elements for a given library and projectile. Returns element symbols.",
+  {
+    library: z.string().describe("Library ID, e.g. 'tendl-2024', 'endfb-8.1'"),
+    projectile: z.string().describe("Projectile: n, p, d, t, h, a, g")
+  },
+  async ({ library, projectile }) => {
+    const lib = CATALOG.libraries[library];
+    if (!lib) throw new Error(`Unknown library: ${library}. Use list_libraries to see available libraries.`);
+    if (!lib.projectiles.includes(projectile)) {
+      throw new Error(`Projectile '${projectile}' not available for ${library}. Available: ${lib.projectiles.join(", ")}`);
+    }
+    const manifest = await fetchManifest(library);
+    const elements = manifest.elements ?? [];
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify({ library, projectile, elements, count: elements.length }, null, 2)
+      }]
+    };
+  }
+);
+server.tool(
+  "get_cross_sections",
+  "Get nuclear reaction cross-section data for a specific target element. Returns energy (MeV) and cross-section (mb) arrays with reaction product info.",
+  {
+    library: z.string().describe("Library ID, e.g. 'tendl-2024'"),
+    projectile: z.string().describe("Projectile: n, p, d, t, h, a, g"),
+    element: z.string().describe("Target element symbol, e.g. 'Cu', 'Fe', 'Au'"),
+    max_rows: z.number().optional().describe("Max rows to return (default 500)")
+  },
+  async ({ library, projectile, element, max_rows }) => {
+    const lib = CATALOG.libraries[library];
+    if (!lib) throw new Error(`Unknown library: ${library}`);
+    const parquetPath = `${lib.path}${projectile}_${element}.parquet`;
+    const rows = await fetchParquetRows(parquetPath);
+    const result = truncateRows(rows, max_rows ?? 500);
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify({
+          library,
+          projectile,
+          element,
+          ...result
+        }, null, 2)
+      }]
+    };
+  }
+);
+server.tool(
+  "get_decay_data",
+  "Get radioactive decay data (half-lives, decay modes, daughters) for a nuclide or element. Filter by Z and/or A.",
+  {
+    z: z.number().optional().describe("Atomic number (e.g. 92 for U)"),
+    a: z.number().optional().describe("Mass number (e.g. 238)")
+  },
+  async ({ z: zNum, a: aNum }) => {
+    if (zNum === void 0 && aNum === void 0) {
+      throw new Error("Provide at least z or a to filter decay data.");
+    }
+    const metaPath = CATALOG.shared.meta.path + CATALOG.shared.meta.files.decay;
+    const rows = await fetchParquetRows(metaPath);
+    const filtered = rows.filter((row) => {
+      if (zNum !== void 0 && row["Z"] !== zNum) return false;
+      if (aNum !== void 0 && row["A"] !== aNum) return false;
+      return true;
+    });
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify({ z: zNum, a: aNum, count: filtered.length, rows: filtered }, null, 2)
+      }]
+    };
+  }
+);
+server.tool(
+  "get_abundances",
+  "Get natural isotope abundances and atomic masses for an element.",
+  {
+    z: z.number().describe("Atomic number (e.g. 29 for Cu)")
+  },
+  async ({ z: zNum }) => {
+    const metaPath = CATALOG.shared.meta.path + CATALOG.shared.meta.files.abundances;
+    const rows = await fetchParquetRows(metaPath);
+    const filtered = rows.filter((row) => row["Z"] === zNum);
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify({ z: zNum, count: filtered.length, isotopes: filtered }, null, 2)
+      }]
+    };
+  }
+);
+server.tool(
+  "get_stopping_power",
+  "Get mass stopping power (dE/dx) data for a projectile in a target element.",
+  {
+    source: z.string().describe(
+      "Data source: PSTAR (protons), ASTAR (\u03B1, NIST ICRU-49), ESTAR (electrons), dSTAR, tSTAR (velocity-scaled from PSTAR), or catima (full Z\xD7Z table; \u03B1/\xB3He fallback for non-NIST elements)"
+    ),
+    target_z: z.number().describe("Target element atomic number")
+  },
+  async ({ source, target_z }) => {
+    const fileMap = CATALOG.shared.stopping.files;
+    if (!(source in fileMap)) {
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({
+            error: `unknown source ${source}; valid: ${CATALOG.shared.stopping.sources.join(", ")}`
+          }, null, 2)
+        }]
+      };
+    }
+    const stoppingPath = CATALOG.shared.stopping.path + fileMap[source];
+    const rows = await fetchParquetRows(stoppingPath);
+    const filtered = rows.filter((row) => row["target_Z"] === target_z);
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify({
+          source,
+          target_z,
+          count: filtered.length,
+          rows: filtered
+        }, null, 2)
+      }]
+    };
+  }
+);
+var transport = new StdioServerTransport();
+await server.connect(transport);
+export {
+  fetchParquetRows,
+  getCatalog
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { parquetRead } from \"hyparquet\";\nimport { compressors } from \"hyparquet-compressors\";\nimport { z } from \"zod\";\n\n// ---------------------------------------------------------------------------\n// Configuration\n// ---------------------------------------------------------------------------\n\nconst BASE_URL =\n  process.env.NUCL_PARQUET_BASE_URL ??\n  \"https://raw.githubusercontent.com/exoma-ch/nucl-parquet/main/data/\";\n\n// ---------------------------------------------------------------------------\n// Embedded catalog (from catalog.json)\n// ---------------------------------------------------------------------------\n\ninterface Library {\n  name: string;\n  description: string;\n  source_url: string;\n  projectiles: string[];\n  data_type: string;\n  version: string;\n  path: string;\n}\n\ninterface Catalog {\n  libraries: Record<string, Library>;\n  shared: {\n    meta: { path: string; files: Record<string, string> };\n    stopping: { path: string; files: Record<string, string>; sources: string[] };\n  };\n}\n\nconst CATALOG: Catalog = {\n  libraries: {\n    \"tendl-2024\": { name: \"TENDL-2024\", description: \"TALYS Evaluated Nuclear Data Library 2024 (IAEA/PSI)\", source_url: \"https://tendl.web.psi.ch/tendl_2024/tendl2024.html\", projectiles: [\"p\", \"d\", \"t\", \"h\", \"a\"], data_type: \"cross_sections\", version: \"2024\", path: \"tendl-2024/xs/\" },\n    \"endfb-8.1\": { name: \"ENDF/B-VIII.1\", description: \"US Evaluated Nuclear Data File (NNDC/BNL)\", source_url: \"https://www.nndc.bnl.gov/endf-b8.1/\", projectiles: [\"n\", \"p\", \"d\", \"t\", \"h\", \"a\"], data_type: \"cross_sections\", version: \"VIII.1\", path: \"endfb-8.1/xs/\" },\n    \"jeff-4.0\": { name: \"JEFF-4.0\", description: \"Joint Evaluated Fission and Fusion File (NEA)\", source_url: \"https://www.oecd-nea.org/dbdata/jeff/\", projectiles: [\"n\", \"p\"], data_type: \"cross_sections\", version: \"4.0\", path: \"jeff-4.0/xs/\" },\n    \"jendl-5\": { name: \"JENDL-5\", description: \"Japanese Evaluated Nuclear Data Library (JAEA)\", source_url: \"https://wwwndc.jaea.go.jp/jendl/j5/j5.html\", projectiles: [\"n\", \"p\", \"d\", \"a\"], data_type: \"cross_sections\", version: \"5\", path: \"jendl-5/xs/\" },\n    \"tendl-2025\": { name: \"TENDL-2025\", description: \"TALYS Evaluated Nuclear Data Library 2025 (PSI)\", source_url: \"https://tendl.web.psi.ch/\", projectiles: [\"n\", \"p\", \"d\", \"t\", \"h\", \"a\"], data_type: \"cross_sections\", version: \"2025\", path: \"tendl-2025/xs/\" },\n    \"cendl-3.2\": { name: \"CENDL-3.2\", description: \"Chinese Evaluated Nuclear Data Library (CIAE)\", source_url: \"http://www.nuclear.csdb.cn/\", projectiles: [\"n\"], data_type: \"cross_sections\", version: \"3.2\", path: \"cendl-3.2/xs/\" },\n    \"brond-3.1\": { name: \"BROND-3.1\", description: \"Russian Evaluated Nuclear Data Library (IPPE)\", source_url: \"https://vant.ippe.ru/\", projectiles: [\"n\"], data_type: \"cross_sections\", version: \"3.1\", path: \"brond-3.1/xs/\" },\n    \"fendl-3.2\": { name: \"FENDL-3.2\", description: \"Fusion Evaluated Nuclear Data Library (IAEA)\", source_url: \"https://www-nds.iaea.org/fendl/\", projectiles: [\"n\"], data_type: \"cross_sections\", version: \"3.2\", path: \"fendl-3.2/xs/\" },\n    \"eaf-2010\": { name: \"EAF-2010\", description: \"European Activation File (CCFE)\", source_url: \"https://fispact.ukaea.uk/\", projectiles: [\"n\"], data_type: \"cross_sections\", version: \"2010\", path: \"eaf-2010/xs/\" },\n    \"irdff-2\": { name: \"IRDFF-II\", description: \"International Reactor Dosimetry and Fusion File (IAEA)\", source_url: \"https://www-nds.iaea.org/IRDFF/\", projectiles: [\"n\"], data_type: \"cross_sections\", version: \"II\", path: \"irdff-2/xs/\" },\n    \"iaea-medical\": { name: \"IAEA-Medical\", description: \"Medical isotope production cross-sections (IAEA)\", source_url: \"https://www-nds.iaea.org/medical/\", projectiles: [\"p\", \"d\", \"h\", \"a\"], data_type: \"cross_sections\", version: \"latest\", path: \"iaea-medical/xs/\" },\n    \"jendl-ad-2017\": { name: \"JENDL/AD-2017\", description: \"Activation/Dosimetry Library (JAEA)\", source_url: \"https://wwwndc.jaea.go.jp/jendl/jad/jad.html\", projectiles: [\"n\", \"p\"], data_type: \"cross_sections\", version: \"2017\", path: \"jendl-ad-2017/xs/\" },\n    \"jendl-deu-2020\": { name: \"JENDL-DEU-2020\", description: \"Dedicated deuteron-induced reaction library (JAEA)\", source_url: \"https://wwwndc.jaea.go.jp/jendl/deu/deu.html\", projectiles: [\"d\"], data_type: \"cross_sections\", version: \"2020\", path: \"jendl-deu-2020/xs/\" },\n    \"iaea-pd-2019\": { name: \"IAEA-PD-2019\", description: \"Photonuclear Data Library (IAEA)\", source_url: \"https://www-nds.iaea.org/photonuclear/\", projectiles: [\"g\"], data_type: \"cross_sections\", version: \"2019\", path: \"iaea-pd-2019/xs/\" },\n    \"exfor\": { name: \"EXFOR\", description: \"Experimental nuclear reaction data (IAEA NDS)\", source_url: \"https://www-nds.iaea.org/exfor/\", projectiles: [\"n\", \"p\", \"d\", \"t\", \"h\", \"a\"], data_type: \"experimental_cross_sections\", version: \"latest\", path: \"exfor/\" },\n  },\n  shared: {\n    meta: { path: \"meta/\", files: { abundances: \"abundances.parquet\", decay: \"decay.parquet\", elements: \"elements.parquet\" } },\n    stopping: {\n      path: \"stopping/\",\n      files: {\n        PSTAR: \"PSTAR.parquet\",\n        ASTAR: \"ASTAR.parquet\",\n        ESTAR: \"ESTAR.parquet\",\n        dSTAR: \"dSTAR.parquet\",\n        tSTAR: \"tSTAR.parquet\",\n        catima: \"catima/catima.parquet\",\n      } as Record<string, string>,\n      sources: [\"PSTAR\", \"ASTAR\", \"ESTAR\", \"dSTAR\", \"tSTAR\", \"catima\"],\n    },\n  },\n};\n\n// ---------------------------------------------------------------------------\n// Parquet fetch + cache\n// ---------------------------------------------------------------------------\n\nconst parquetCache = new Map<string, Record<string, unknown>[]>();\n\nexport async function fetchParquetRows(\n  relativePath: string,\n  baseUrl: string = BASE_URL,\n): Promise<Record<string, unknown>[]> {\n  if (parquetCache.has(relativePath)) return parquetCache.get(relativePath)!;\n\n  const url = new URL(relativePath, baseUrl).href;\n  const resp = await fetch(url);\n  if (!resp.ok) throw new Error(`HTTP ${resp.status} fetching ${url}`);\n  const buffer = await resp.arrayBuffer();\n\n  const rows: Record<string, unknown>[] = [];\n  await parquetRead({\n    file: buffer,\n    compressors,\n    rowFormat: \"object\",\n    onComplete: (data: Record<string, unknown>[]) => {\n      rows.push(...data);\n    },\n  });\n\n  parquetCache.set(relativePath, rows);\n  return rows;\n}\n\nasync function fetchManifest(libraryId: string): Promise<Record<string, unknown>> {\n  const lib = CATALOG.libraries[libraryId];\n  if (!lib) throw new Error(`Unknown library: ${libraryId}`);\n  const manifestPath = lib.path.replace(/xs\\/$/, \"manifest.json\");\n  const url = new URL(manifestPath, BASE_URL).href;\n  const resp = await fetch(url);\n  if (!resp.ok) throw new Error(`HTTP ${resp.status} fetching manifest for ${libraryId}`);\n  return (await resp.json()) as Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nexport function getCatalog(): Catalog {\n  return CATALOG;\n}\n\nfunction truncateRows(rows: Record<string, unknown>[], limit: number): { rows: Record<string, unknown>[]; truncated: boolean; total: number } {\n  if (rows.length <= limit) return { rows, truncated: false, total: rows.length };\n  return { rows: rows.slice(0, limit), truncated: true, total: rows.length };\n}\n\n// ---------------------------------------------------------------------------\n// MCP Server\n// ---------------------------------------------------------------------------\n\nconst server = new McpServer({\n  name: \"nucl-parquet\",\n  version: \"0.3.7\",\n});\n\nserver.tool(\n  \"list_libraries\",\n  \"List all available nuclear data libraries with projectiles and descriptions\",\n  {},\n  async () => {\n    const libs = Object.entries(CATALOG.libraries).map(([id, lib]) => ({\n      id,\n      name: lib.name,\n      description: lib.description,\n      projectiles: lib.projectiles,\n      version: lib.version,\n      data_type: lib.data_type,\n    }));\n    return { content: [{ type: \"text\" as const, text: JSON.stringify(libs, null, 2) }] };\n  },\n);\n\nserver.tool(\n  \"list_isotopes\",\n  \"List available target elements for a given library and projectile. Returns element symbols.\",\n  {\n    library: z.string().describe(\"Library ID, e.g. 'tendl-2024', 'endfb-8.1'\"),\n    projectile: z.string().describe(\"Projectile: n, p, d, t, h, a, g\"),\n  },\n  async ({ library, projectile }) => {\n    const lib = CATALOG.libraries[library];\n    if (!lib) throw new Error(`Unknown library: ${library}. Use list_libraries to see available libraries.`);\n    if (!lib.projectiles.includes(projectile)) {\n      throw new Error(`Projectile '${projectile}' not available for ${library}. Available: ${lib.projectiles.join(\", \")}`);\n    }\n\n    const manifest = await fetchManifest(library);\n    const elements = (manifest.elements as string[]) ?? [];\n\n    return {\n      content: [{\n        type: \"text\" as const,\n        text: JSON.stringify({ library, projectile, elements, count: elements.length }, null, 2),\n      }],\n    };\n  },\n);\n\nserver.tool(\n  \"get_cross_sections\",\n  \"Get nuclear reaction cross-section data for a specific target element. Returns energy (MeV) and cross-section (mb) arrays with reaction product info.\",\n  {\n    library: z.string().describe(\"Library ID, e.g. 'tendl-2024'\"),\n    projectile: z.string().describe(\"Projectile: n, p, d, t, h, a, g\"),\n    element: z.string().describe(\"Target element symbol, e.g. 'Cu', 'Fe', 'Au'\"),\n    max_rows: z.number().optional().describe(\"Max rows to return (default 500)\"),\n  },\n  async ({ library, projectile, element, max_rows }) => {\n    const lib = CATALOG.libraries[library];\n    if (!lib) throw new Error(`Unknown library: ${library}`);\n\n    const parquetPath = `${lib.path}${projectile}_${element}.parquet`;\n    const rows = await fetchParquetRows(parquetPath);\n    const result = truncateRows(rows, max_rows ?? 500);\n\n    return {\n      content: [{\n        type: \"text\" as const,\n        text: JSON.stringify({\n          library,\n          projectile,\n          element,\n          ...result,\n        }, null, 2),\n      }],\n    };\n  },\n);\n\nserver.tool(\n  \"get_decay_data\",\n  \"Get radioactive decay data (half-lives, decay modes, daughters) for a nuclide or element. Filter by Z and/or A.\",\n  {\n    z: z.number().optional().describe(\"Atomic number (e.g. 92 for U)\"),\n    a: z.number().optional().describe(\"Mass number (e.g. 238)\"),\n  },\n  async ({ z: zNum, a: aNum }) => {\n    if (zNum === undefined && aNum === undefined) {\n      throw new Error(\"Provide at least z or a to filter decay data.\");\n    }\n\n    const metaPath = CATALOG.shared.meta.path + CATALOG.shared.meta.files.decay;\n    const rows = await fetchParquetRows(metaPath);\n\n    const filtered = rows.filter((row) => {\n      if (zNum !== undefined && row[\"Z\"] !== zNum) return false;\n      if (aNum !== undefined && row[\"A\"] !== aNum) return false;\n      return true;\n    });\n\n    return {\n      content: [{\n        type: \"text\" as const,\n        text: JSON.stringify({ z: zNum, a: aNum, count: filtered.length, rows: filtered }, null, 2),\n      }],\n    };\n  },\n);\n\nserver.tool(\n  \"get_abundances\",\n  \"Get natural isotope abundances and atomic masses for an element.\",\n  {\n    z: z.number().describe(\"Atomic number (e.g. 29 for Cu)\"),\n  },\n  async ({ z: zNum }) => {\n    const metaPath = CATALOG.shared.meta.path + CATALOG.shared.meta.files.abundances;\n    const rows = await fetchParquetRows(metaPath);\n\n    const filtered = rows.filter((row) => row[\"Z\"] === zNum);\n\n    return {\n      content: [{\n        type: \"text\" as const,\n        text: JSON.stringify({ z: zNum, count: filtered.length, isotopes: filtered }, null, 2),\n      }],\n    };\n  },\n);\n\nserver.tool(\n  \"get_stopping_power\",\n  \"Get mass stopping power (dE/dx) data for a projectile in a target element.\",\n  {\n    source: z.string().describe(\n      \"Data source: PSTAR (protons), ASTAR (α, NIST ICRU-49), ESTAR (electrons), dSTAR, tSTAR (velocity-scaled from PSTAR), or catima (full Z×Z table; α/³He fallback for non-NIST elements)\",\n    ),\n    target_z: z.number().describe(\"Target element atomic number\"),\n  },\n  async ({ source, target_z }) => {\n    // Post-#143: aggregate stopping.parquet is deleted; route per-source.\n    const fileMap = CATALOG.shared.stopping.files;\n    if (!(source in fileMap)) {\n      return {\n        content: [{\n          type: \"text\" as const,\n          text: JSON.stringify({\n            error: `unknown source ${source}; valid: ${CATALOG.shared.stopping.sources.join(\", \")}`,\n          }, null, 2),\n        }],\n      };\n    }\n    const stoppingPath = CATALOG.shared.stopping.path + fileMap[source];\n    const rows = await fetchParquetRows(stoppingPath);\n\n    // catima uses (proj_Z, target_Z); NIST tables use (source, target_Z).\n    // Filter by target_Z in both cases — the file already restricts to one source.\n    const filtered = rows.filter((row) => row[\"target_Z\"] === target_z);\n\n    return {\n      content: [{\n        type: \"text\" as const,\n        text: JSON.stringify({\n          source,\n          target_z,\n          count: filtered.length,\n          rows: filtered,\n        }, null, 2),\n      }],\n    };\n  },\n);\n\n// ---------------------------------------------------------------------------\n// Main\n// ---------------------------------------------------------------------------\n\nconst transport = new StdioServerTransport();\nawait server.connect(transport);\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@nucl-parquet/mcp",
+  "version": "0.13.2",
+  "description": "MCP server for nuclear data — lazy-loads Parquet from GitHub",
+  "type": "module",
+  "bin": {
+    "nucl-parquet-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "start": "node dist/index.js"
+  },
+  "repository": "https://github.com/exoma-ch/nucl-parquet",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "hyparquet": "^1.7.0",
+    "hyparquet-compressors": "^1.1.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^2.0.0"
+  }
+}