@cyanheads/pubchem-mcp-server 0.1.1

package/dist/mcp-server/tools/definitions/get-compound-details.tool.js

@@ -0,0 +1,190 @@
+/**
+ * @fileoverview Get detailed compound information: physicochemical properties,
+ * textual descriptions, and/or synonyms for one or more CIDs.
+ * @module mcp-server/tools/definitions/get-compound-details
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getPubChemClient } from '../../../services/pubchem/pubchem-client.js';
+import { COMPOUND_PROPERTIES, DEFAULT_PROPERTIES } from '../../../services/pubchem/types.js';
+const propertyEnum = z.enum(COMPOUND_PROPERTIES);
+export const getCompoundDetails = tool('pubchem_get_compound_details', {
+    title: 'Get Compound Details',
+    description: 'Get detailed compound information by CID. Returns physicochemical properties ' +
+        '(molecular weight, SMILES, InChIKey, XLogP, TPSA, etc.), optionally with a textual ' +
+        'description (pharmacology, mechanism, therapeutic use) and/or all known synonyms. ' +
+        'Efficiently batches up to 100 CIDs in a single request.',
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+    input: z.object({
+        cids: z
+            .array(z.number().int().positive())
+            .min(1)
+            .max(100)
+            .describe('PubChem Compound IDs to fetch (1-100). Batched efficiently.'),
+        properties: z
+            .array(propertyEnum)
+            .optional()
+            .describe('Properties to retrieve. Defaults to a core set: MolecularFormula, MolecularWeight, ' +
+            'IUPACName, CanonicalSMILES, IsomericSMILES, InChIKey, XLogP, TPSA, HBondDonorCount, ' +
+            'HBondAcceptorCount, RotatableBondCount, HeavyAtomCount, Charge, Complexity.'),
+        includeDescription: z
+            .boolean()
+            .default(false)
+            .describe('Fetch textual description from PUG View (pharmacology, mechanism, therapeutic use). ' +
+            'Adds one API call per CID — consider limiting CID count when enabled.'),
+        includeSynonyms: z
+            .boolean()
+            .default(false)
+            .describe('Fetch all known names and synonyms (trade names, systematic names, registry numbers).'),
+    }),
+    output: z.object({
+        compounds: z
+            .array(z.object({
+            cid: z.number().describe('PubChem Compound ID.'),
+            properties: z
+                .record(z.string(), z.unknown())
+                .describe('Requested physicochemical properties.'),
+            description: z.string().optional().describe('Textual description from PUG View.'),
+            synonyms: z.array(z.string()).optional().describe('Known names and synonyms.'),
+        }))
+            .describe('Compound detail records.'),
+    }),
+    async handler(input, ctx) {
+        const client = getPubChemClient();
+        const props = input.properties ?? [...DEFAULT_PROPERTIES];
+        // Batch property fetch
+        const propertyRows = await client.getProperties(input.cids, props);
+        const propsMap = new Map(propertyRows.map((r) => [r.CID, r]));
+        // Optional: descriptions (per-CID, parallelized with concurrency limit)
+        let descMap;
+        if (input.includeDescription) {
+            const descCids = input.cids.slice(0, 10); // Cap at 10 to limit API calls
+            if (descCids.length < input.cids.length) {
+                ctx.log.info('Description fetch capped at 10 CIDs', {
+                    requested: input.cids.length,
+                    fetching: descCids.length,
+                });
+            }
+            const entries = await Promise.all(descCids.map(async (cid) => {
+                const desc = await client.getDescription(cid);
+                return [cid, desc];
+            }));
+            descMap = new Map(entries.filter((e) => e[1] !== null));
+        }
+        // Optional: synonyms (per-CID)
+        let synMap;
+        if (input.includeSynonyms) {
+            const entries = await Promise.all(input.cids.map(async (cid) => {
+                const syns = await client.getSynonyms(cid);
+                return [cid, syns];
+            }));
+            synMap = new Map(entries.filter((e) => e[1].length > 0));
+        }
+        ctx.log.info('Details fetched', {
+            cids: input.cids.length,
+            withDescription: input.includeDescription,
+            withSynonyms: input.includeSynonyms,
+        });
+        const compounds = input.cids.map((cid) => {
+            const rawProps = propsMap.get(cid) ?? {};
+            const properties = { ...rawProps };
+            delete properties.CID;
+            const compound = { cid, properties };
+            const desc = descMap?.get(cid);
+            if (desc)
+                compound.description = desc;
+            const syns = synMap?.get(cid);
+            if (syns)
+                compound.synonyms = syns;
+            return compound;
+        });
+        return { compounds };
+    },
+    format(result) {
+        const blocks = [];
+        for (const c of result.compounds) {
+            const p = c.properties;
+            const name = p.IUPACName ?? p.Title ?? '';
+            const header = name ? `## CID ${c.cid} — ${name}` : `## CID ${c.cid}`;
+            blocks.push(header);
+            const lines = [];
+            // Key identifiers
+            if (p.MolecularFormula)
+                lines.push(`**Formula:** ${p.MolecularFormula}`);
+            const mw = p.MolecularWeight;
+            if (mw != null)
+                lines.push(`**MW:** ${mw} g/mol`);
+            if (p.CanonicalSMILES)
+                lines.push(`**SMILES:** ${p.CanonicalSMILES}`);
+            if (p.IsomericSMILES && p.IsomericSMILES !== p.CanonicalSMILES) {
+                lines.push(`**Isomeric SMILES:** ${p.IsomericSMILES}`);
+            }
+            if (p.InChIKey)
+                lines.push(`**InChIKey:** ${p.InChIKey}`);
+            // Drug-likeness properties
+            const drugProps = [];
+            if (p.XLogP != null)
+                drugProps.push(`XLogP: ${p.XLogP}`);
+            if (p.TPSA != null)
+                drugProps.push(`TPSA: ${p.TPSA}`);
+            if (p.Complexity != null)
+                drugProps.push(`Complexity: ${p.Complexity}`);
+            if (drugProps.length > 0)
+                lines.push(`**Properties:** ${drugProps.join(' | ')}`);
+            // Atom/bond counts
+            const counts = [];
+            if (p.HBondDonorCount != null)
+                counts.push(`HBD: ${p.HBondDonorCount}`);
+            if (p.HBondAcceptorCount != null)
+                counts.push(`HBA: ${p.HBondAcceptorCount}`);
+            if (p.RotatableBondCount != null)
+                counts.push(`Rotatable: ${p.RotatableBondCount}`);
+            if (p.HeavyAtomCount != null)
+                counts.push(`Heavy: ${p.HeavyAtomCount}`);
+            if (p.Charge != null && p.Charge !== 0)
+                counts.push(`Charge: ${p.Charge}`);
+            if (counts.length > 0)
+                lines.push(`**Counts:** ${counts.join(' | ')}`);
+            // Remaining properties not already shown
+            const shown = new Set([
+                'MolecularFormula',
+                'MolecularWeight',
+                'CanonicalSMILES',
+                'IsomericSMILES',
+                'InChIKey',
+                'IUPACName',
+                'Title',
+                'XLogP',
+                'TPSA',
+                'Complexity',
+                'HBondDonorCount',
+                'HBondAcceptorCount',
+                'RotatableBondCount',
+                'HeavyAtomCount',
+                'Charge',
+            ]);
+            const extra = Object.entries(p).filter(([k]) => !shown.has(k));
+            if (extra.length > 0) {
+                lines.push(extra.map(([k, v]) => `**${k}:** ${v}`).join(' | '));
+            }
+            blocks.push(lines.join('\n'));
+            // Description
+            if (c.description) {
+                blocks.push(`\n> ${c.description.replace(/\n/g, '\n> ')}`);
+            }
+            // Synonyms
+            if (c.synonyms && c.synonyms.length > 0) {
+                const shown = c.synonyms.slice(0, 20);
+                const more = c.synonyms.length > 20 ? ` (+${c.synonyms.length - 20} more)` : '';
+                blocks.push(`\n**Synonyms:** ${shown.join(', ')}${more}`);
+            }
+            blocks.push('');
+        }
+        return [{ type: 'text', text: blocks.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-compound-details.tool.js.map

package/dist/mcp-server/tools/definitions/get-compound-details.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-compound-details.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-compound-details.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/get-compound-image.tool.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview Fetch a 2D structure diagram (PNG) for a PubChem compound.
+ * @module mcp-server/tools/definitions/get-compound-image
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const getCompoundImage: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    cid: z.ZodNumber;
+    size: z.ZodDefault<z.ZodEnum<{
+        small: "small";
+        large: "large";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    cid: z.ZodNumber;
+    imageBase64: z.ZodString;
+    mimeType: z.ZodString;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+}, z.core.$strip>>;
+//# sourceMappingURL=get-compound-image.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-compound-image.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-compound-image.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-compound-image.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAQjD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;kBAiD3B,CAAC"}

package/dist/mcp-server/tools/definitions/get-compound-image.tool.js

@@ -0,0 +1,57 @@
+/**
+ * @fileoverview Fetch a 2D structure diagram (PNG) for a PubChem compound.
+ * @module mcp-server/tools/definitions/get-compound-image
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getPubChemClient } from '../../../services/pubchem/pubchem-client.js';
+/** Convert ArrayBuffer to base64 string */
+function arrayBufferToBase64(buffer) {
+    return Buffer.from(buffer).toString('base64');
+}
+export const getCompoundImage = tool('pubchem_get_compound_image', {
+    title: 'Get Compound Image',
+    description: 'Fetch a 2D structure diagram (PNG image) for a compound by CID.',
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+    input: z.object({
+        cid: z.number().int().positive().describe('PubChem Compound ID.'),
+        size: z
+            .enum(['small', 'large'])
+            .default('large')
+            .describe('Image size: "small" (100x100) or "large" (300x300). Default: "large".'),
+    }),
+    output: z.object({
+        cid: z.number().describe('PubChem Compound ID.'),
+        imageBase64: z.string().describe('Base64-encoded PNG image data.'),
+        mimeType: z.string().describe('Image MIME type.'),
+        width: z.number().describe('Image width in pixels.'),
+        height: z.number().describe('Image height in pixels.'),
+    }),
+    async handler(input, ctx) {
+        const client = getPubChemClient();
+        const buffer = await client.getImage(input.cid, input.size);
+        const dim = input.size === 'small' ? 100 : 300;
+        ctx.log.info('Image fetched', { cid: input.cid, size: input.size, bytes: buffer.byteLength });
+        return {
+            cid: input.cid,
+            imageBase64: arrayBufferToBase64(buffer),
+            mimeType: 'image/png',
+            width: dim,
+            height: dim,
+        };
+    },
+    format(result) {
+        return [
+            { type: 'image', data: result.imageBase64, mimeType: result.mimeType },
+            {
+                type: 'text',
+                text: `2D structure for CID ${result.cid} (${result.width}x${result.height})`,
+            },
+        ];
+    },
+});
+//# sourceMappingURL=get-compound-image.tool.js.map

package/dist/mcp-server/tools/definitions/get-compound-image.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-compound-image.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-compound-image.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAExE,2CAA2C;AAC3C,SAAS,mBAAmB,CAAC,MAAmB;IAC9C,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC,4BAA4B,EAAE;IACjE,KAAK,EAAE,oBAAoB;IAC3B,WAAW,EAAE,iEAAiE;IAC9E,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACpB;IACD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACjE,IAAI,EAAE,CAAC;aACJ,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;aACxB,OAAO,CAAC,OAAO,CAAC;aAChB,QAAQ,CAAC,uEAAuE,CAAC;KACrF,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QAChD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;QAClE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QACjD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;QACpD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;KACvD,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5D,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAE/C,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QAE9F,OAAO;YACL,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,WAAW,EAAE,mBAAmB,CAAC,MAAM,CAAC;YACxC,QAAQ,EAAE,WAAW;YACrB,KAAK,EAAE,GAAG;YACV,MAAM,EAAE,GAAG;SACZ,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,MAAM;QACX,OAAO;YACL,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE;YACtE;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,wBAAwB,MAAM,CAAC,GAAG,KAAK,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,GAAG;aAC9E;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/get-compound-safety.tool.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview Get GHS hazard classification and safety data for a PubChem compound.
+ * @module mcp-server/tools/definitions/get-compound-safety
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const getCompoundSafety: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    cid: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    cid: z.ZodNumber;
+    hasData: z.ZodBoolean;
+    ghs: z.ZodOptional<z.ZodObject<{
+        signalWord: z.ZodOptional<z.ZodString>;
+        pictograms: z.ZodArray<z.ZodString>;
+        hazardStatements: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            statement: z.ZodString;
+        }, z.core.$strip>>;
+        precautionaryStatements: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            statement: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    source: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+//# sourceMappingURL=get-compound-safety.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-compound-safety.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-compound-safety.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-compound-safety.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAGjD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;kBAoG5B,CAAC"}

package/dist/mcp-server/tools/definitions/get-compound-safety.tool.js

@@ -0,0 +1,94 @@
+/**
+ * @fileoverview Get GHS hazard classification and safety data for a PubChem compound.
+ * @module mcp-server/tools/definitions/get-compound-safety
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getPubChemClient } from '../../../services/pubchem/pubchem-client.js';
+export const getCompoundSafety = tool('pubchem_get_compound_safety', {
+    title: 'Get Compound Safety',
+    description: 'Get GHS (Globally Harmonized System) hazard classification and safety data for a compound. ' +
+        'Returns signal word, pictograms, hazard statements (H-codes), and precautionary statements (P-codes). ' +
+        'Data sourced from PubChem depositors — source attribution included.',
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+    input: z.object({
+        cid: z.number().int().positive().describe('PubChem Compound ID.'),
+    }),
+    output: z.object({
+        cid: z.number().describe('PubChem Compound ID.'),
+        hasData: z.boolean().describe('Whether GHS safety data is available for this compound.'),
+        ghs: z
+            .object({
+            signalWord: z.string().optional().describe('GHS signal word: "Danger" or "Warning".'),
+            pictograms: z
+                .array(z.string())
+                .describe('GHS pictogram labels (e.g. "Flammable", "Toxic").'),
+            hazardStatements: z
+                .array(z.object({
+                code: z.string().describe('H-code (e.g. "H225").'),
+                statement: z.string().describe('Hazard statement text.'),
+            }))
+                .describe('GHS hazard statements.'),
+            precautionaryStatements: z
+                .array(z.object({
+                code: z.string().describe('P-code (e.g. "P210").'),
+                statement: z.string().describe('Precautionary statement text.'),
+            }))
+                .describe('GHS precautionary statements.'),
+        })
+            .optional()
+            .describe('GHS classification data.'),
+        source: z.string().optional().describe('Data source attribution.'),
+    }),
+    async handler(input, ctx) {
+        const client = getPubChemClient();
+        const data = await client.getSafetyData(input.cid);
+        ctx.log.info('Safety data fetched', { cid: input.cid, hasData: data !== null });
+        if (!data) {
+            return { cid: input.cid, hasData: false };
+        }
+        return {
+            cid: input.cid,
+            hasData: true,
+            ghs: {
+                signalWord: data.signalWord,
+                pictograms: data.pictograms,
+                hazardStatements: data.hazardStatements,
+                precautionaryStatements: data.precautionaryStatements,
+            },
+            source: data.source,
+        };
+    },
+    format(result) {
+        if (!result.hasData || !result.ghs) {
+            return [{ type: 'text', text: `No GHS safety data available for CID ${result.cid}.` }];
+        }
+        const lines = [`## GHS Safety — CID ${result.cid}`, ''];
+        const g = result.ghs;
+        if (g.signalWord)
+            lines.push(`**Signal Word:** ${g.signalWord}`);
+        if (g.pictograms.length > 0)
+            lines.push(`**Pictograms:** ${g.pictograms.join(', ')}`);
+        if (g.hazardStatements.length > 0) {
+            lines.push('', '**Hazard Statements:**');
+            for (const h of g.hazardStatements) {
+                lines.push(`  ${h.code}: ${h.statement}`);
+            }
+        }
+        if (g.precautionaryStatements.length > 0) {
+            lines.push('', '**Precautionary Statements:**');
+            for (const p of g.precautionaryStatements) {
+                lines.push(`  ${p.code}: ${p.statement}`);
+            }
+        }
+        if (result.source) {
+            lines.push('', `*Source: ${result.source}*`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-compound-safety.tool.js.map

package/dist/mcp-server/tools/definitions/get-compound-safety.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-compound-safety.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-compound-safety.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/get-compound-xrefs.tool.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Get external database cross-references for a PubChem compound.
+ * @module mcp-server/tools/definitions/get-compound-xrefs
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const getCompoundXrefs: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    cid: z.ZodNumber;
+    xrefTypes: z.ZodArray<z.ZodEnum<{
+        [x: string]: string;
+    }>>;
+    maxPerType: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    cid: z.ZodNumber;
+    xrefs: z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        ids: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        totalAvailable: z.ZodNumber;
+        truncated: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=get-compound-xrefs.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-compound-xrefs.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-compound-xrefs.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-compound-xrefs.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAMjD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;kBAqG3B,CAAC"}

package/dist/mcp-server/tools/definitions/get-compound-xrefs.tool.js

@@ -0,0 +1,90 @@
+/**
+ * @fileoverview Get external database cross-references for a PubChem compound.
+ * @module mcp-server/tools/definitions/get-compound-xrefs
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getPubChemClient } from '../../../services/pubchem/pubchem-client.js';
+import { XREF_TYPES } from '../../../services/pubchem/types.js';
+const xrefTypeEnum = z.enum(XREF_TYPES);
+export const getCompoundXrefs = tool('pubchem_get_compound_xrefs', {
+    title: 'Get Compound Cross-References',
+    description: 'Get external database cross-references for a compound: PubMed citations, patent IDs, ' +
+        'gene/protein associations, registry numbers, and taxonomy IDs. Results are capped per ' +
+        'type with total counts reported.',
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+    input: z.object({
+        cid: z.number().int().positive().describe('PubChem Compound ID.'),
+        xrefTypes: z
+            .array(xrefTypeEnum)
+            .min(1)
+            .describe('Cross-reference types to retrieve. Options: RegistryID, RN (CAS numbers), ' +
+            'PubMedID, PatentID, GeneID, ProteinGI, TaxonomyID.'),
+        maxPerType: z
+            .number()
+            .min(1)
+            .max(500)
+            .default(50)
+            .describe('Max IDs to return per xref type (1-500). A compound may have thousands of PubMed ' +
+            'references — this cap prevents bloat. Total count always reported. Default: 50.'),
+    }),
+    output: z.object({
+        cid: z.number().describe('PubChem Compound ID.'),
+        xrefs: z
+            .array(z.object({
+            type: z.string().describe('Cross-reference type.'),
+            ids: z
+                .array(z.union([z.string(), z.number()]))
+                .describe('Cross-reference IDs (capped by maxPerType).'),
+            totalAvailable: z.number().describe('Total IDs available before truncation.'),
+            truncated: z.boolean().describe('Whether results were truncated.'),
+        }))
+            .describe('Cross-references grouped by type.'),
+    }),
+    async handler(input, ctx) {
+        const client = getPubChemClient();
+        // Sequential per type to avoid rate limit spikes
+        const xrefs = [];
+        for (const xrefType of input.xrefTypes) {
+            const allIds = await client.getXrefs(input.cid, xrefType);
+            const totalAvailable = allIds.length;
+            const ids = allIds.slice(0, input.maxPerType);
+            xrefs.push({
+                type: xrefType,
+                ids,
+                totalAvailable,
+                truncated: totalAvailable > input.maxPerType,
+            });
+        }
+        ctx.log.info('Xrefs fetched', {
+            cid: input.cid,
+            types: input.xrefTypes,
+            totalIds: xrefs.reduce((sum, x) => sum + x.ids.length, 0),
+        });
+        return { cid: input.cid, xrefs };
+    },
+    format(result) {
+        const lines = [`Cross-references for CID ${result.cid}`, ''];
+        for (const xref of result.xrefs) {
+            const countInfo = xref.truncated
+                ? `${xref.ids.length} of ${xref.totalAvailable} total`
+                : `${xref.totalAvailable} total`;
+            lines.push(`**${xref.type}** (${countInfo})`);
+            if (xref.ids.length > 0) {
+                const display = xref.ids.slice(0, 20);
+                const more = xref.ids.length > 20 ? `, ... (+${xref.ids.length - 20} more)` : '';
+                lines.push(`  ${display.join(', ')}${more}`);
+            }
+            else {
+                lines.push('  None found');
+            }
+            lines.push('');
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-compound-xrefs.tool.js.map

package/dist/mcp-server/tools/definitions/get-compound-xrefs.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-compound-xrefs.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-compound-xrefs.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/get-summary.tool.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview Get descriptive summaries for PubChem entities: assays, genes,
+ * proteins, pathways, taxonomy, cell lines, or substances.
+ * @module mcp-server/tools/definitions/get-summary
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const getSummary: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    entityType: z.ZodEnum<{
+        assay: "assay";
+        gene: "gene";
+        protein: "protein";
+        taxonomy: "taxonomy";
+    }>;
+    identifiers: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+}, z.core.$strip>, z.ZodObject<{
+    entityType: z.ZodString;
+    summaries: z.ZodArray<z.ZodObject<{
+        identifier: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+        found: z.ZodBoolean;
+        data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=get-summary.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-summary.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-summary.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-summary.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAOjD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;kBA8FrB,CAAC"}