open-museum-mcp 0.1.0

package/dist/fetchers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/fetchers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/fetchers/types.ts"],"names":[],"mappings":""}

package/dist/licenseGate.d.ts

@@ -0,0 +1,13 @@
+import type { ArtworkLicense } from './types.js';
+export interface LicenseDecision {
+    accepted: boolean;
+    license: ArtworkLicense | null;
+    imageOpenAccess: boolean;
+    metadataOpenAccess: boolean;
+    reason: string;
+}
+export type LicenseValidator = (raw: unknown) => LicenseDecision;
+export declare const validateMetLicense: LicenseValidator;
+export declare const validateClevelandLicense: LicenseValidator;
+export declare const validateAicLicense: LicenseValidator;
+export declare function validateLicense(museumCode: string, raw: unknown): LicenseDecision;

package/dist/licenseGate.js

@@ -0,0 +1,112 @@
+function nowIso() {
+    return new Date().toISOString();
+}
+function reject(reason) {
+    return {
+        accepted: false,
+        license: null,
+        imageOpenAccess: false,
+        metadataOpenAccess: false,
+        reason,
+    };
+}
+// The Met's `isPublicDomain` boolean is the museum's per-object marker for
+// images released under CC0. We accept it as sufficient for both
+// imageOpenAccess and metadataOpenAccess because that is what the Met itself
+// publishes. This is not an independent rights audit — third-party content,
+// model releases, or culturally sensitive material may carry obligations the
+// museum's representation does not surface. See README "Disclaimer".
+export const validateMetLicense = (raw) => {
+    if (!raw || typeof raw !== 'object') {
+        return reject('met: object missing or not an object');
+    }
+    const obj = raw;
+    const isPD = obj.isPublicDomain;
+    if (isPD === true) {
+        return {
+            accepted: true,
+            license: {
+                type: 'CC0',
+                rawValue: 'true',
+                verificationSource: 'met.isPublicDomain',
+                verifiedAt: nowIso(),
+                confidence: 'high',
+            },
+            imageOpenAccess: true,
+            metadataOpenAccess: true,
+            reason: 'met: isPublicDomain=true',
+        };
+    }
+    if (isPD === false) {
+        return reject('met: isPublicDomain=false');
+    }
+    return reject('met: isPublicDomain field missing or non-boolean (strict default reject)');
+};
+export const validateClevelandLicense = (raw) => {
+    if (!raw || typeof raw !== 'object') {
+        return reject('cleveland: object missing or not an object');
+    }
+    const obj = raw;
+    const status = obj.share_license_status;
+    if (typeof status === 'string' && status.toUpperCase() === 'CC0') {
+        return {
+            accepted: true,
+            license: {
+                type: 'CC0',
+                rawValue: status,
+                verificationSource: 'cleveland.share_license_status',
+                verifiedAt: nowIso(),
+                confidence: 'high',
+            },
+            imageOpenAccess: true,
+            metadataOpenAccess: true,
+            reason: 'cleveland: share_license_status=CC0',
+        };
+    }
+    return reject(`cleveland: share_license_status=${typeof status === 'string' ? status : 'missing'} (strict default reject)`);
+};
+// The Art Institute of Chicago's API returns is_public_domain as a per-object
+// boolean. AIC's documentation explicitly notes that the API's CC0 framing
+// covers the catalog data, while image reuse rights are described separately
+// in their image licensing materials. The per-object boolean does mark images
+// they release under CC0, so we accept it for imageOpenAccess — but the
+// distinction matters: AIC's docs caution that even CC0-marked content may
+// involve third-party permissions or culturally sensitive material. We
+// surface this caveat in the README "Disclaimer" rather than downgrading
+// confidence here, because the museum's own representation is unambiguous.
+export const validateAicLicense = (raw) => {
+    if (!raw || typeof raw !== 'object') {
+        return reject('aic: object missing or not an object');
+    }
+    const obj = raw;
+    const isPD = obj.is_public_domain;
+    if (isPD === true) {
+        return {
+            accepted: true,
+            license: {
+                type: 'CC0',
+                rawValue: 'true',
+                verificationSource: 'aic.is_public_domain',
+                verifiedAt: nowIso(),
+                confidence: 'high',
+            },
+            imageOpenAccess: true,
+            metadataOpenAccess: true,
+            reason: 'aic: is_public_domain=true',
+        };
+    }
+    return reject(`aic: is_public_domain=${isPD} (strict default reject)`);
+};
+const VALIDATORS = {
+    met: validateMetLicense,
+    cleveland: validateClevelandLicense,
+    aic: validateAicLicense,
+};
+export function validateLicense(museumCode, raw) {
+    const v = VALIDATORS[museumCode];
+    if (!v) {
+        return reject(`unknown museum '${museumCode}': strict default reject`);
+    }
+    return v(raw);
+}
+//# sourceMappingURL=licenseGate.js.map

package/dist/licenseGate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"licenseGate.js","sourceRoot":"","sources":["../src/licenseGate.ts"],"names":[],"mappings":"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"}

package/dist/mappings.d.ts

@@ -0,0 +1,3 @@
+export declare function normalizeRegion(input: string | null | undefined): string | null;
+export declare function detectAttributionType(artistName: string | null | undefined): 'named' | 'anonymous' | 'workshop' | 'after' | 'attributed' | 'circle' | 'follower';
+export declare function cleanArtistName(input: string): string;

package/dist/mappings.js

@@ -0,0 +1,36 @@
+import regionsData from './data/regions.json' with { type: 'json' };
+const regionMap = regionsData;
+export function normalizeRegion(input) {
+    if (!input)
+        return null;
+    const lower = input.toLowerCase();
+    for (const [canonical, aliases] of Object.entries(regionMap)) {
+        if (aliases.some((alias) => lower.includes(alias))) {
+            return canonical;
+        }
+    }
+    return null;
+}
+const ATTRIBUTION_PATTERNS = [
+    { test: /\bworkshop of\b/i, type: 'workshop' },
+    { test: /\battributed to\b/i, type: 'attributed' },
+    { test: /\bcircle of\b/i, type: 'circle' },
+    { test: /\bfollower of\b/i, type: 'follower' },
+    { test: /\bafter\b/i, type: 'after' },
+    { test: /^(unknown|anonymous|unidentified)/i, type: 'anonymous' },
+];
+export function detectAttributionType(artistName) {
+    if (!artistName || !artistName.trim())
+        return 'anonymous';
+    for (const { test, type } of ATTRIBUTION_PATTERNS) {
+        if (test.test(artistName))
+            return type;
+    }
+    return 'named';
+}
+export function cleanArtistName(input) {
+    return input
+        .replace(/^(workshop of|attributed to|circle of|follower of|after)\s+/i, '')
+        .trim();
+}
+//# sourceMappingURL=mappings.js.map

package/dist/mappings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mappings.js","sourceRoot":"","sources":["../src/mappings.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,qBAAqB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAEpE,MAAM,SAAS,GAAG,WAAuC,CAAC;AAE1D,MAAM,UAAU,eAAe,CAAC,KAAgC;IAC9D,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAClC,KAAK,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7D,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACnD,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,oBAAoB,GAGrB;IACH,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,UAAU,EAAE;IAC9C,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,YAAY,EAAE;IAClD,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC1C,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,UAAU,EAAE;IAC9C,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE;IACrC,EAAE,IAAI,EAAE,oCAAoC,EAAE,IAAI,EAAE,WAAW,EAAE;CAClE,CAAC;AAEF,MAAM,UAAU,qBAAqB,CACnC,UAAqC;IAErC,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE;QAAE,OAAO,WAAW,CAAC;IAC1D,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,oBAAoB,EAAE,CAAC;QAClD,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;YAAE,OAAO,IAAI,CAAC;IACzC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,KAAK;SACT,OAAO,CAAC,8DAA8D,EAAE,EAAE,CAAC;SAC3E,IAAI,EAAE,CAAC;AACZ,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/server.js

@@ -0,0 +1,243 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { cite } from './cite.js';
+import { Cache } from './db.js';
+import { metFetcher } from './fetchers/met.js';
+const FETCHERS = {
+    [metFetcher.code]: metFetcher,
+};
+const CACHE_PATH = process.env.OMM_CACHE_PATH ?? join(homedir(), '.open-museum-mcp', 'cache.db');
+const cache = new Cache({ path: CACHE_PATH });
+// Museum IDs are positive integers (no leading zeros). Tightening the regex
+// here makes `met:000123` and `met:0` user errors rather than valid IDs that
+// produce duplicate cache rows.
+const ID_REGEX = /^[a-z]+:[1-9]\d*$/;
+// Cap concurrent fetches to one museum's API. The Met has no batch endpoint,
+// so a search of limit 50 fans out into up to 50 object fetches; without a
+// cap, we'd hammer the upstream and risk rate-limit errors. 8 is empirically
+// gentle and keeps wall-clock time within the same order of magnitude.
+const FETCH_CONCURRENCY = 8;
+async function withConcurrency(items, limit, fn) {
+    const results = new Array(items.length);
+    let next = 0;
+    const workers = Array.from({ length: Math.min(limit, items.length) }, async () => {
+        while (true) {
+            const idx = next++;
+            if (idx >= items.length)
+                return;
+            results[idx] = await fn(items[idx]);
+        }
+    });
+    await Promise.all(workers);
+    return results;
+}
+const SearchInput = z.object({
+    query: z.string().min(1),
+    museum: z.string().optional(),
+    has_image: z.boolean().default(true),
+    limit: z.number().int().min(1).max(50).default(10),
+});
+const GetInput = z.object({
+    id: z.string().regex(ID_REGEX),
+});
+const CiteInput = z.object({
+    id: z.string().regex(ID_REGEX),
+    style: z.enum(['short', 'full', 'caption']).default('full'),
+});
+async function fetchAndCache(id) {
+    if (!ID_REGEX.test(id)) {
+        return { ok: false, reason: `invalid artwork id: ${id}` };
+    }
+    const cached = cache.getObject(id);
+    if (cached)
+        return { ok: true, artwork: cached };
+    // ID_REGEX guarantees a non-empty `[a-z]+` segment before ':'.
+    const code = id.slice(0, id.indexOf(':'));
+    const fetcher = FETCHERS[code];
+    if (!fetcher)
+        return { ok: false, reason: `unknown museum code: ${code}` };
+    const raw = await fetcher.getRaw(id);
+    const result = fetcher.normalize(raw);
+    if (result.status === 'rejected') {
+        // Rejections are expected — strict-default-deny is the project's spine.
+        // Log to stderr (stdout is the MCP protocol channel) so operators can
+        // diagnose "why did my search return fewer results than expected?".
+        console.error(`[open-museum-mcp] rejected ${id}: ${result.rejection.reason}`);
+        return { ok: false, reason: result.rejection.reason };
+    }
+    cache.upsertObject(result.artwork);
+    return { ok: true, artwork: result.artwork };
+}
+const server = new Server({ name: 'open-museum-mcp', version: '0.1.0' }, {
+    capabilities: {
+        tools: {},
+        resources: {},
+    },
+});
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: 'search_artworks',
+            description: 'Search across registered open-access museum collections. Returns artwork records that pass source-specific rights verification (ambiguous records excluded by default).',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string', description: 'Free-text query.' },
+                    museum: {
+                        type: 'string',
+                        description: 'Optional museum code. Currently registered: met. (Cleveland, AIC adapters are planned for v0.2.)',
+                    },
+                    has_image: {
+                        type: 'boolean',
+                        default: true,
+                        description: 'Restrict to records with an image URL. Defaults to true. Note: some museums (e.g. The Met) only expose images-only search server-side.',
+                    },
+                    limit: { type: 'integer', minimum: 1, maximum: 50, default: 10 },
+                },
+                required: ['query'],
+            },
+        },
+        {
+            name: 'get_artwork',
+            description: 'Fetch a single artwork by its normalized ID (e.g. met:436533).',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    id: { type: 'string', description: 'Normalized artwork ID, format museumcode:numericid' },
+                },
+                required: ['id'],
+            },
+        },
+        {
+            name: 'cite',
+            description: 'Render a citation for an artwork. Styles: "full" (artist, title, date, museum, license, URL), "caption" (image caption form), "short" (inline reference).',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    id: { type: 'string', description: 'Normalized artwork ID.' },
+                    style: {
+                        type: 'string',
+                        enum: ['short', 'full', 'caption'],
+                        default: 'full',
+                    },
+                },
+                required: ['id'],
+            },
+        },
+    ],
+}));
+function errorResult(message) {
+    return { content: [{ type: 'text', text: message }], isError: true };
+}
+// The cache key includes the overfetch count, not the user-facing `limit`.
+// That means limit:5 and limit:6 produce different keys (since 5*2=10 vs
+// 6*2=12). The trade-off: more cache rows, but each row is guaranteed to
+// hold enough IDs to satisfy a request at its overfetch tier even after
+// rights-gate rejections. Bucketing would need explicit refill logic.
+function searchCacheKey(query, museum, hasImage, overFetch) {
+    return JSON.stringify({ q: query, m: museum ?? '*', hi: hasImage, of: overFetch });
+}
+async function handleSearch(args) {
+    const input = SearchInput.parse(args);
+    const fetchers = input.museum
+        ? (FETCHERS[input.museum] ? [FETCHERS[input.museum]] : [])
+        : Object.values(FETCHERS);
+    if (fetchers.length === 0) {
+        return errorResult(`unknown museum: ${input.museum}`);
+    }
+    const overFetch = input.has_image ? input.limit * 2 : input.limit;
+    const cacheKey = searchCacheKey(input.query, input.museum, input.has_image, overFetch);
+    let allIds = cache.getQuery(cacheKey);
+    if (!allIds) {
+        const idLists = await Promise.all(fetchers.map((f) => f.search(input.query, overFetch, { hasImage: input.has_image }).catch(() => [])));
+        allIds = idLists.flat();
+        cache.putQuery(cacheKey, allIds);
+    }
+    const fetched = await withConcurrency(allIds, FETCH_CONCURRENCY, (id) => fetchAndCache(id).catch((err) => ({
+        ok: false,
+        reason: err instanceof Error ? err.message : 'fetch failed',
+    })));
+    const accepted = fetched
+        .filter((r) => r.ok)
+        .map((r) => r.artwork);
+    const filtered = accepted.filter((a) => !input.has_image || Boolean(a.imageUrls.full));
+    const results = filtered.slice(0, input.limit);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({ count: results.length, results }, null, 2),
+            },
+        ],
+    };
+}
+async function handleGet(args) {
+    const input = GetInput.parse(args);
+    const out = await fetchAndCache(input.id);
+    if (!out.ok)
+        return errorResult(out.reason);
+    return { content: [{ type: 'text', text: JSON.stringify(out.artwork, null, 2) }] };
+}
+async function handleCite(args) {
+    const input = CiteInput.parse(args);
+    const out = await fetchAndCache(input.id);
+    if (!out.ok)
+        return errorResult(out.reason);
+    return { content: [{ type: 'text', text: cite(out.artwork, input.style) }] };
+}
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        if (name === 'search_artworks')
+            return await handleSearch(args);
+        if (name === 'get_artwork')
+            return await handleGet(args);
+        if (name === 'cite')
+            return await handleCite(args);
+        return errorResult(`unknown tool: ${name}`);
+    }
+    catch (err) {
+        if (err instanceof z.ZodError) {
+            return errorResult(`invalid input: ${err.issues.map((i) => `${i.path.join('.')}: ${i.message}`).join('; ')}`);
+        }
+        if (err instanceof Error) {
+            return errorResult(`${name} failed: ${err.message}`);
+        }
+        return errorResult(`${name} failed with unknown error`);
+    }
+});
+server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+    resources: [],
+}));
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+    const uri = request.params.uri;
+    const m = uri.match(/^museum:\/\/([a-z]+)\/(.+)$/);
+    if (!m) {
+        throw new Error(`invalid museum URI scheme: ${uri}`);
+    }
+    const id = `${m[1]}:${m[2]}`;
+    if (!ID_REGEX.test(id)) {
+        throw new Error(`invalid museum URI: ${uri} (id must match ${ID_REGEX})`);
+    }
+    const out = await fetchAndCache(id);
+    if (!out.ok) {
+        throw new Error(`cannot resolve ${uri}: ${out.reason}`);
+    }
+    return {
+        contents: [
+            {
+                uri,
+                mimeType: 'application/json',
+                text: JSON.stringify(out.artwork, null, 2),
+            },
+        ],
+    };
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,88 @@
+export type LicenseType = 'CC0' | 'PD' | 'CC-BY' | 'CC-BY-SA' | 'OTHER' | 'UNKNOWN';
+export type AttributionType = 'named' | 'anonymous' | 'workshop' | 'after' | 'attributed' | 'circle' | 'follower';
+export interface Artist {
+    name: string;
+    nationality?: string;
+    lifespan?: string;
+    attributionType: AttributionType;
+}
+export type RightsConfidence = 'high' | 'medium' | 'low';
+export interface ArtworkLicense {
+    type: LicenseType;
+    rawValue: string;
+    verificationSource: string;
+    verifiedAt: string;
+    confidence: RightsConfidence;
+}
+export interface ArtworkImages {
+    full: string;
+    large?: string;
+    thumbnail?: string;
+}
+export interface ArtworkSource {
+    apiUrl: string;
+    pageUrl: string;
+}
+export interface MuseumRef {
+    code: string;
+    name: string;
+    url: string;
+}
+export interface Artwork {
+    id: string;
+    museum: MuseumRef;
+    title: string;
+    artist: Artist;
+    displayDate: string;
+    yearStart: number | null;
+    yearEnd: number | null;
+    medium: string;
+    region: string | null;
+    period: string | null;
+    imageUrls: ArtworkImages;
+    imageOpenAccess: boolean;
+    metadataOpenAccess: boolean;
+    license: ArtworkLicense;
+    source: ArtworkSource;
+    description?: string;
+    rawTags?: string[];
+    /** Reserved for v1.0 artist-obscurity scoring across the federated corpus. Not yet populated by any fetcher. */
+    obscurityScore?: number;
+}
+/**
+ * `rawSnapshot` preserves the museum's verbatim response when a record is
+ * rejected by the rights gate. It exists for two purposes only:
+ *   1. Debugging when a museum quietly changes a field name; the snapshot
+ *      shows what they actually returned.
+ *   2. Authoring rejection fixtures by copying a real-world rejection into
+ *      `tests/fixtures/`.
+ * Never expose this on the wire to MCP clients — it can include arbitrary
+ * museum payload contents that aren't meant for end users.
+ */
+export interface RejectedArtwork {
+    id: string;
+    museumCode: string;
+    reason: string;
+    rawSnapshot: unknown;
+}
+export type ValidationResult = {
+    status: 'accepted';
+    artwork: Artwork;
+} | {
+    status: 'rejected';
+    rejection: RejectedArtwork;
+};
+export interface DateRange {
+    yearStart: number | null;
+    yearEnd: number | null;
+}
+/**
+ * Reserved for v0.2 list_traditions tool: each normalized tradition tag will
+ * carry per-museum coverage counts so callers can see where holdings live
+ * before searching. Not yet emitted by any tool.
+ */
+export interface Tradition {
+    tag: string;
+    label: string;
+    coverage: Record<string, number>;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "open-museum-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for license-verified search across open-access museum collections (The Met, Cleveland, AIC and more).",
+  "type": "module",
+  "main": "dist/server.js",
+  "bin": {
+    "open-museum-mcp": "dist/server.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cfpramod/open-museum-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/cfpramod/open-museum-mcp/issues"
+  },
+  "homepage": "https://github.com/cfpramod/open-museum-mcp#readme",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/server.ts",
+    "prepare": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "museum",
+    "open-access",
+    "art",
+    "metropolitan-museum",
+    "cleveland-museum",
+    "art-institute-chicago"
+  ],
+  "author": "Pramod Prasanth",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "better-sqlite3": "^11.5.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.11",
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vitest": "^4.1.5"
+  }
+}