@mrfentmen/smk-mcp 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,33 @@
-# Temporary Holding Version
+# SMK National Gallery of Denmark
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+SMK open collection: search 200k+ artworks by keyword or artist and read object details with images - keyless.
+
+Keyless — no signup, no API key, no environment variables.
+
+## Install
+
+```bash
+npx -y @mrfentmen/smk-mcp
+```
+
+Or add it to your MCP client:
+
+```json
+{
+  "mcpServers": {
+    "smk-mcp": { "command": "npx", "args": ["-y", "@mrfentmen/smk-mcp"] }
+  }
+}
+```
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `search_art` | Search the SMK collection by keyword and list matching artworks with dates and artists. |
+| `search_by_artist` | Find artworks by an artist name, filtered from a keyword search. |
+| `artwork_detail` | One artwork in full: title, artist(s), production date, techniques, dimensions and image links. |
+
+## Data source
+
+SMK (Statens Museum for Kunst) open API (api.smk.dk), no key required

package/dist/api.d.ts

@@ -0,0 +1,17 @@
+export declare class SourceError extends Error {
+}
+export declare function getJson(path: string, accept?: string, timeoutMs?: number): Promise<any>;
+export declare function clampLimit(n: number | undefined, fallback: number, max: number): number;
+export declare function clean(s: unknown): string;
+export declare function bullet(label: string, value: unknown): string;
+export declare function searchArt(a: {
+    query: string;
+    limit?: number;
+}): Promise<string>;
+export declare function searchByArtist(a: {
+    artist: string;
+    limit?: number;
+}): Promise<string>;
+export declare function artworkDetail(a: {
+    objectNumber: string;
+}): Promise<string>;

package/dist/api.js

@@ -0,0 +1,159 @@
+/**
+ * SMK National Gallery of Denmark — keyless public API client.
+ */
+const BASE = "https://api.smk.dk/api/v1";
+const SOURCE = "SMK National Gallery of Denmark";
+export class SourceError extends Error {
+}
+async function request(path, accept = "application/json", timeoutMs = 25000) {
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), timeoutMs);
+    try {
+        const res = await fetch(path.startsWith("http") ? path : BASE + path, {
+            signal: ctrl.signal,
+            headers: { "user-agent": "smk-mcp", accept },
+        });
+        if (!res.ok)
+            throw new SourceError(`${SOURCE} responded ${res.status}`);
+        return res;
+    }
+    catch (e) {
+        if (e instanceof SourceError)
+            throw e;
+        if (e.name === "AbortError")
+            throw new SourceError(`${SOURCE} request timed out`);
+        throw new SourceError(`${SOURCE} request failed: ${e.message}`);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export async function getJson(path, accept = "application/json", timeoutMs = 25000) {
+    const res = await request(path, accept, timeoutMs);
+    const body = await res.text();
+    try {
+        return JSON.parse(body);
+    }
+    catch {
+        throw new SourceError(`${SOURCE} returned malformed JSON`);
+    }
+}
+export function clampLimit(n, fallback, max) {
+    const v = n ?? fallback;
+    if (!Number.isInteger(v) || v < 1 || v > max)
+        throw new SourceError(`limit must be between 1 and ${max}`);
+    return v;
+}
+export function clean(s) {
+    return String(s ?? "").replace(/\s+/g, " ").trim();
+}
+export function bullet(label, value) {
+    const v = value === undefined || value === null || value === "" ? "" : String(value);
+    return v ? `${label}: ${v}` : "";
+}
+function title(item) {
+    if (Array.isArray(item?.titles) && item.titles.length)
+        return clean(item.titles[0]?.title);
+    return clean(item?.title);
+}
+function artists(item) {
+    const out = [];
+    for (const key of ["artist", "artists"]) {
+        const value = item?.[key];
+        if (Array.isArray(value)) {
+            for (const a of value)
+                out.push(clean(a?.name ?? a?.full_name ?? a));
+        }
+    }
+    return [...new Set(out.filter(Boolean))];
+}
+function dates(item) {
+    const value = item?.production_date;
+    if (Array.isArray(value) && value.length) {
+        const first = value[0];
+        if (Array.isArray(first?.period))
+            return first.period.map((p) => clean(p)).filter(Boolean).join("-");
+        return clean(first?.period ?? first);
+    }
+    return clean(item?.production_date);
+}
+function thumbs(item) {
+    return clean(item?.image_thumbnail ?? item?.image_native ?? "");
+}
+async function search(keys, limit) {
+    const data = await getJson(`/art/search/?keys=${encodeURIComponent(keys)}&offset=0&limit=${Math.max(limit, 10)}&filters=%5Bhas_image%3Atrue%5D`, "application/json", 30000);
+    const items = data?.items;
+    if (!Array.isArray(items))
+        throw new SourceError("SMK returned an unexpected payload");
+    return items;
+}
+export async function searchArt(a) {
+    const limit = clampLimit(a.limit, 10, 50);
+    const q = clean(a.query);
+    const items = await search(q, limit);
+    const withImages = items.filter((i) => thumbs(i));
+    const shown = (withImages.length ? withImages : items).slice(0, limit);
+    if (!shown.length)
+        return `SMK has no artworks matching "${q}".`;
+    return [
+        `${items.length} result(s) for "${q}" (showing ${shown.length}${withImages.length ? ", images only" : ""}):`,
+        "",
+        ...shown.map((item, i) => {
+            const who = artists(item);
+            const when = dates(item);
+            const bits = [when, who.slice(0, 2).join(", ")].filter(Boolean);
+            return `${i + 1}. ${title(item) || "(untitled)"} · ${clean(item?.object_number)}${bits.length ? `\n   ${bits.join(" · ")}` : ""}`;
+        }),
+    ].join("\n");
+}
+export async function searchByArtist(a) {
+    const limit = clampLimit(a.limit, 10, 50);
+    const name = clean(a.artist);
+    const items = await search(name, Math.max(limit, 30));
+    const needle = name.toLowerCase();
+    const hits = items.filter((item) => artists(item).some((aName) => aName.toLowerCase().includes(needle)));
+    if (!hits.length)
+        return `No SMK artworks found with an artist matching "${name}".`;
+    return [
+        `${hits.length} artwork(s) with an artist matching "${name}" (showing ${Math.min(limit, hits.length)}):`,
+        "",
+        ...hits.slice(0, limit).map((item, i) => {
+            const who = artists(item);
+            const when = dates(item);
+            return `${i + 1}. ${title(item) || "(untitled)"} · ${clean(item?.object_number)}${who.length ? `\n   ${who.join(", ")}${when ? ` · ${when}` : ""}` : ""}`;
+        }),
+    ].join("\n");
+}
+export async function artworkDetail(a) {
+    const id = clean(a.objectNumber);
+    if (!/^[A-Za-z0-9._-]{2,40}$/.test(id))
+        throw new SourceError(`"${id}" is not a valid SMK object number`);
+    const data = await getJson(`/art/?object_number=${encodeURIComponent(id)}`, "application/json", 30000);
+    const item = Array.isArray(data?.items) ? data.items[0] : undefined;
+    if (!item)
+        throw new SourceError(`SMK has no object "${id}"`);
+    const techniques = Array.isArray(item?.techniques) ? item.techniques.map((t) => clean(t)).filter(Boolean) : [];
+    const dims = [];
+    for (const d of Array.isArray(item?.dimensions) ? item.dimensions : []) {
+        const parts = [clean(d?.type), d?.value !== undefined ? `${clean(d.value)} ${clean(d?.unit)}`.trim() : ""].filter(Boolean);
+        if (parts.length)
+            dims.push(parts.join(" "));
+    }
+    const description = clean(item?.content_description ?? item?.description);
+    const image = thumbs(item);
+    const native = clean(item?.image_native);
+    return [
+        `${title(item) || "(untitled)"} (${clean(item?.object_number)})`,
+        "",
+        bullet("artist(s)", artists(item).join(", ")),
+        bullet("production", dates(item)),
+        bullet("techniques", techniques.join(", ")),
+        bullet("dimensions", dims.slice(0, 4).join("; ")),
+        bullet("department", item?.responsible_department),
+        bullet("acquisition", item?.acquisition_date ? clean(item.acquisition_date).slice(0, 10) : ""),
+        "",
+        description ? description.slice(0, 600) : "No catalogue description on record.",
+        image ? `\nThumbnail: ${image}` : "",
+        native ? `Image: ${native}` : "",
+    ].filter(Boolean).join("\n").replace(/\n{3,}/g, "\n\n").trim();
+}

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,12 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("smk-mcp running on stdio");
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(): McpServer;

package/dist/server.js

@@ -0,0 +1,45 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { artworkDetail, searchArt, searchByArtist, SourceError } from "./api.js";
+const text = (t) => ({ content: [{ type: "text", text: t }] });
+function errorMessage(e) {
+    if (e instanceof SourceError || e instanceof Error)
+        return `Error: ${e.message}`;
+    return `Error: ${String(e)}`;
+}
+export function createServer() {
+    const server = new McpServer({ name: "smk-mcp", version: "1.0.0" });
+    server.tool("search_art", "Search the SMK collection by keyword and list matching artworks with dates and artists.", {
+        query: z.string().min(1).describe("Search words, e.g. portrait or Christmas"),
+        limit: z.number().int().min(1).max(50).default(10).describe("Artworks to return")
+    }, async (a) => {
+        try {
+            return text(await searchArt(a));
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: errorMessage(e) }], isError: true };
+        }
+    });
+    server.tool("search_by_artist", "Find artworks by an artist name, filtered from a keyword search.", {
+        artist: z.string().min(2).describe("Artist name, e.g. Hammershøi"),
+        limit: z.number().int().min(1).max(50).default(10).describe("Artworks to return")
+    }, async (a) => {
+        try {
+            return text(await searchByArtist(a));
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: errorMessage(e) }], isError: true };
+        }
+    });
+    server.tool("artwork_detail", "One artwork in full: title, artist(s), production date, techniques, dimensions and image links.", {
+        objectNumber: z.string().min(2).describe("SMK object number, e.g. KKSgb2964")
+    }, async (a) => {
+        try {
+            return text(await artworkDetail(a));
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: errorMessage(e) }], isError: true };
+        }
+    });
+    return server;
+}

package/package.json

@@ -1,6 +1,43 @@
 {
   "name": "@mrfentmen/smk-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "SMK open collection: search 200k+ artworks by keyword or artist and read object details with images - keyless.",
+  "type": "module",
+  "mcpName": "io.github.mrfentmen/smk-mcp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mrfentmen/awesome-servers.git"
+  },
+  "bin": {
+    "smk-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "art",
+    "museum",
+    "denmark",
+    "collection",
+    "culture",
+    "keyless"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}