art-institute-mcp 1.0.0

package/README.md

@@ -0,0 +1,22 @@
+# art-institute-mcp
+
+Art Institute of Chicago collection search.
+
+A merged MCP server that consolidates duplicate single-purpose servers in this monorepo into one focused server.
+
+## Tools
+
+- `search` — Search Art Institute of Chicago artworks.
+- `artwork` — Details for one artwork.
+
+## Run
+
+```bash
+npm install
+npm run build
+node dist/index.js
+```
+
+## Source
+
+Public free APIs only. See `src/api.ts` for exact endpoints.

package/dist/api.js

@@ -0,0 +1,113 @@
+const m0 = (() => {
+    const BASE = 'https://api.artic.edu/api/v1';
+    function pick(obj, key) {
+        return obj?.[key] ?? '';
+    }
+    function firstText(value) {
+        if (typeof value === 'string')
+            return value;
+        if (Array.isArray(value))
+            return value.map((v) => (typeof v === 'string' ? v : '')).filter(Boolean).join(', ');
+        return '';
+    }
+    async function search(args) {
+        const q = (args.query ?? '').trim();
+        if (!q)
+            return 'Provide a search query.';
+        const limit = Math.max(1, Math.min(args.limit ?? 10, 30));
+        const url = `${BASE}/artworks/search?q=${encodeURIComponent(q)}&limit=${limit}&fields=id,title,artist_title,date_display,image_id`;
+        const res = await fetch(url, {
+            headers: { 'User-Agent': 'mrfentmen-art-institute-mcp/1.0', Accept: 'application/json' },
+            signal: AbortSignal.timeout(20000),
+        });
+        if (!res.ok)
+            throw new Error(`Art Institute search returned ${res.status}`);
+        const data = (await res.json());
+        const rows = (data.data ?? []).map((d) => {
+            const o = d;
+            const imageId = pick(o, 'image_id');
+            return `${pick(o, 'title')} | ${firstText(pick(o, 'artist_title'))} | ${pick(o, 'date_display')} | id ${pick(o, 'id')}${imageId ? ` | image https://www.artic.edu/iiif/2/${imageId}/full/843,/0/default.jpg` : ''}`;
+        });
+        if (!rows.length)
+            return `No artworks found for "${q}".`;
+        return `Art Institute results for "${q}" (${rows.length} shown):\n` + rows.map((r, i) => `${i + 1}. ${r}`).join('\n');
+    }
+    async function artwork(args) {
+        const url = `${BASE}/artworks/${args.id}?fields=id,title,artist_title,date_display,medium_display,description,image_id`;
+        const res = await fetch(url, {
+            headers: { 'User-Agent': 'mrfentmen-art-institute-mcp/1.0', Accept: 'application/json' },
+            signal: AbortSignal.timeout(20000),
+        });
+        if (!res.ok)
+            throw new Error(`Art Institute fetch returned ${res.status}`);
+        const data = (await res.json());
+        const o = (data.data ?? {});
+        const imageId = pick(o, 'image_id');
+        const lines = [
+            `Title: ${pick(o, 'title')}`,
+            `Artist: ${firstText(pick(o, 'artist_title'))}`,
+            `Date: ${pick(o, 'date_display')}`,
+            `Medium: ${pick(o, 'medium_display')}`,
+        ];
+        const desc = pick(o, 'description');
+        if (desc)
+            lines.push(`Description: ${desc.replace(/<[^>]+>/g, ' ').replace(/\s+/g, ' ').trim().slice(0, 400)}`);
+        if (imageId)
+            lines.push(`Image: https://www.artic.edu/iiif/2/${imageId}/full/843,/0/default.jpg`);
+        return lines.join('\n');
+    }
+    return { artwork, search };
+})();
+const m1 = (() => {
+    const BASE = 'https://api.artic.edu/api/v1/artworks';
+    async function search(args) {
+        const query = (args.query ?? '').trim();
+        if (!query)
+            return 'Provide search terms.';
+        const limit = Math.max(1, Math.min(args.limit ?? 10, 50));
+        const res = await fetch(`${BASE}/search?q=${encodeURIComponent(query)}&limit=${limit}&fields=id,title,artist_title,date_display,image_id`, {
+            headers: { 'User-Agent': 'mrfentmen-artic-mcp/1.0', Accept: 'application/json' },
+            signal: AbortSignal.timeout(20000),
+        });
+        if (!res.ok)
+            throw new Error(`Artic returned ${res.status}`);
+        const d = (await res.json());
+        const rows = d.data ?? [];
+        if (!rows.length)
+            return 'No artworks found.';
+        return `Artworks for "${query}" (${rows.length} shown):\n` +
+            rows.map((r, i) => {
+                const s = (k) => (r[k] != null ? String(r[k]) : '');
+                return `${i + 1}. ${s('title')}${s('artist_title') ? ` by ${s('artist_title')}` : ''}${s('date_display') ? ` (${s('date_display')})` : ''}`;
+            }).join('\n');
+    }
+    async function artwork(args) {
+        const id = Math.floor(args.id ?? 0);
+        if (!id)
+            return 'Provide an artwork id.';
+        const res = await fetch(`${BASE}/${id}?fields=id,title,artist_title,date_display,medium_display,description,image_id`, {
+            headers: { 'User-Agent': 'mrfentmen-artic-mcp/1.0', Accept: 'application/json' },
+            signal: AbortSignal.timeout(20000),
+        });
+        if (!res.ok)
+            throw new Error(`Artic returned ${res.status}`);
+        const d = (await res.json());
+        const r = d.data;
+        if (!r)
+            return `No artwork with id ${id}.`;
+        const s = (k) => (r[k] != null ? String(r[k]) : '');
+        return [
+            `${s('title')}${s('artist_title') ? ` by ${s('artist_title')}` : ''}`,
+            s('date_display') ? `Date: ${s('date_display')}` : '',
+            s('medium_display') ? `Medium: ${s('medium_display')}` : '',
+            s('description') ? `\n${s('description').replace(/<[^>]+>/g, '')}` : '',
+        ].filter(Boolean).join('\n');
+    }
+    return { artwork, search };
+})();
+export const artwork = m0.artwork;
+export const search = m0.search;
+export const m0_search = m0.search;
+export const m0_artwork = m0.artwork;
+export const m1_search = m1.search;
+export const m1_artwork = m1.artwork;

package/dist/index.js

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

package/dist/server.js

@@ -0,0 +1,38 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { m0_artwork, m0_search } from './api.js';
+const text = (value) => ({ content: [{ type: 'text', text: value }] });
+const textError = (t) => ({ content: [{ type: "text", text: t }], isError: true });
+const READ_ONLY = { readOnlyHint: true, openWorldHint: true };
+const error = (e) => `Error: ${e instanceof Error ? e.message : String(e)}`;
+const errorMessage = error;
+export function createServer() {
+    const server = new McpServer({ name: 'art-institute-mcp', version: '1.0.0' });
+    server.registerTool("search", {
+        title: "Search",
+        description: "Search artworks by text.",
+        inputSchema: z.object({ query: z.string().describe("Search terms."), limit: z.number().describe("Max results.").optional() }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        try {
+            return text(await m0_search(args));
+        }
+        catch (e) {
+            return textError(error(e));
+        }
+    });
+    server.registerTool("artwork", {
+        title: "Artwork",
+        description: "Details for one artwork.",
+        inputSchema: z.object({ id: z.number().describe("Artwork ID.") }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        try {
+            return text(await m0_artwork(args));
+        }
+        catch (e) {
+            return textError(error(e));
+        }
+    });
+    return server;
+}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "art-institute-mcp",
+  "version": "1.0.0",
+  "description": "Art Institute of Chicago collection search.",
+  "type": "module",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "@types/node": "^20.0.0"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "mcpName": "io.github.mrfentmen/art-institute-mcp"
+}

package/server.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.mrfentmen/art-institute-mcp",
+  "description": "Art Institute of Chicago collection search.",
+  "repository": {
+    "url": "https://github.com/mrfentmen/awesome-mcps",
+    "source": "github"
+  },
+  "version": "1.0.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "art-institute-mcp",
+      "version": "1.0.0",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}

package/src/api.ts

@@ -0,0 +1,132 @@
+
+export interface m0_SearchArgs {
+  query: string;
+  limit?: number;
+}
+
+export interface m0_ArtworkArgs {
+  id: number;
+}
+
+export interface m1_SearchArgs {
+  query: string;
+  limit?: number;
+}
+
+export interface m1_ArtworkArgs {
+  id: number;
+}
+
+const m0 = (() => {
+const BASE = 'https://api.artic.edu/api/v1';
+
+
+
+function pick<T>(obj: Record<string, unknown>, key: string): T {
+  return (obj?.[key] as T) ?? ('' as T);
+}
+
+function firstText(value: unknown): string {
+  if (typeof value === 'string') return value;
+  if (Array.isArray(value)) return value.map((v) => (typeof v === 'string' ? v : '')).filter(Boolean).join(', ');
+  return '';
+}
+
+async function search(args: m0_SearchArgs): Promise<string> {
+  const q = (args.query ?? '').trim();
+  if (!q) return 'Provide a search query.';
+  const limit = Math.max(1, Math.min(args.limit ?? 10, 30));
+  const url = `${BASE}/artworks/search?q=${encodeURIComponent(q)}&limit=${limit}&fields=id,title,artist_title,date_display,image_id`;
+  const res = await fetch(url, {
+    headers: { 'User-Agent': 'mrfentmen-art-institute-mcp/1.0', Accept: 'application/json' },
+    signal: AbortSignal.timeout(20000),
+  });
+  if (!res.ok) throw new Error(`Art Institute search returned ${res.status}`);
+  const data = (await res.json()) as { data?: unknown[] };
+  const rows = (data.data ?? []).map((d) => {
+    const o = d as Record<string, unknown>;
+    const imageId = pick<string>(o, 'image_id');
+    return `${pick<string>(o, 'title')} | ${firstText(pick(o, 'artist_title'))} | ${pick<string>(o, 'date_display')} | id ${pick<number>(o, 'id')}${imageId ? ` | image https://www.artic.edu/iiif/2/${imageId}/full/843,/0/default.jpg` : ''}`;
+  });
+  if (!rows.length) return `No artworks found for "${q}".`;
+  return `Art Institute results for "${q}" (${rows.length} shown):\n` + rows.map((r, i) => `${i + 1}. ${r}`).join('\n');
+}
+
+async function artwork(args: m0_ArtworkArgs): Promise<string> {
+  const url = `${BASE}/artworks/${args.id}?fields=id,title,artist_title,date_display,medium_display,description,image_id`;
+  const res = await fetch(url, {
+    headers: { 'User-Agent': 'mrfentmen-art-institute-mcp/1.0', Accept: 'application/json' },
+    signal: AbortSignal.timeout(20000),
+  });
+  if (!res.ok) throw new Error(`Art Institute fetch returned ${res.status}`);
+  const data = (await res.json()) as { data?: unknown };
+  const o = (data.data ?? {}) as Record<string, unknown>;
+  const imageId = pick<string>(o, 'image_id');
+  const lines = [
+    `Title: ${pick<string>(o, 'title')}`,
+    `Artist: ${firstText(pick(o, 'artist_title'))}`,
+    `Date: ${pick<string>(o, 'date_display')}`,
+    `Medium: ${pick<string>(o, 'medium_display')}`,
+  ];
+  const desc = pick<string>(o, 'description');
+  if (desc) lines.push(`Description: ${desc.replace(/<[^>]+>/g, ' ').replace(/\s+/g, ' ').trim().slice(0, 400)}`);
+  if (imageId) lines.push(`Image: https://www.artic.edu/iiif/2/${imageId}/full/843,/0/default.jpg`);
+  return lines.join('\n');
+}
+
+return { artwork, search };
+})();
+
+const m1 = (() => {
+const BASE = 'https://api.artic.edu/api/v1/artworks';
+
+
+
+async function search(args: m1_SearchArgs): Promise<string> {
+  const query = (args.query ?? '').trim();
+  if (!query) return 'Provide search terms.';
+  const limit = Math.max(1, Math.min(args.limit ?? 10, 50));
+  const res = await fetch(`${BASE}/search?q=${encodeURIComponent(query)}&limit=${limit}&fields=id,title,artist_title,date_display,image_id`, {
+    headers: { 'User-Agent': 'mrfentmen-artic-mcp/1.0', Accept: 'application/json' },
+    signal: AbortSignal.timeout(20000),
+  });
+  if (!res.ok) throw new Error(`Artic returned ${res.status}`);
+  const d = (await res.json()) as { data?: Array<Record<string, unknown>> };
+  const rows = d.data ?? [];
+  if (!rows.length) return 'No artworks found.';
+  return `Artworks for "${query}" (${rows.length} shown):\n` +
+    rows.map((r, i) => {
+      const s = (k: string) => (r[k] != null ? String(r[k]) : '');
+      return `${i + 1}. ${s('title')}${s('artist_title') ? ` by ${s('artist_title')}` : ''}${s('date_display') ? ` (${s('date_display')})` : ''}`;
+    }).join('\n');
+}
+
+async function artwork(args: m1_ArtworkArgs): Promise<string> {
+  const id = Math.floor(args.id ?? 0);
+  if (!id) return 'Provide an artwork id.';
+  const res = await fetch(`${BASE}/${id}?fields=id,title,artist_title,date_display,medium_display,description,image_id`, {
+    headers: { 'User-Agent': 'mrfentmen-artic-mcp/1.0', Accept: 'application/json' },
+    signal: AbortSignal.timeout(20000),
+  });
+  if (!res.ok) throw new Error(`Artic returned ${res.status}`);
+  const d = (await res.json()) as { data?: Record<string, unknown> };
+  const r = d.data;
+  if (!r) return `No artwork with id ${id}.`;
+  const s = (k: string) => (r[k] != null ? String(r[k]) : '');
+  return [
+    `${s('title')}${s('artist_title') ? ` by ${s('artist_title')}` : ''}`,
+    s('date_display') ? `Date: ${s('date_display')}` : '',
+    s('medium_display') ? `Medium: ${s('medium_display')}` : '',
+    s('description') ? `\n${s('description').replace(/<[^>]+>/g, '')}` : '',
+  ].filter(Boolean).join('\n');
+}
+
+return { artwork, search };
+})();
+
+export const artwork = m0.artwork;
+export const search = m0.search;
+export const m0_search = m0.search;
+export const m0_artwork = m0.artwork;
+export const m1_search = m1.search;
+export const m1_artwork = m1.artwork;

package/src/index.ts

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

package/src/server.ts

@@ -0,0 +1,38 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
+import { z } from 'zod'
+import { m0_artwork, m0_search } from './api.js'
+
+const text = (value: string) => ({ content: [{ type: 'text' as const, text: value }] })
+const textError = (t: string) => ({ content: [{ type: "text" as const, text: t }], isError: true as const })
+const READ_ONLY = { readOnlyHint: true, openWorldHint: true } as const
+const error = (e: unknown) => `Error: ${e instanceof Error ? e.message : String(e)}`
+const errorMessage = error
+
+export function createServer(): McpServer {
+  const server = new McpServer({ name: 'art-institute-mcp', version: '1.0.0' })
+server.registerTool(
+    "search",
+    {
+      title: "Search",
+      description: "Search artworks by text.",
+      inputSchema: z.object( { query: z.string().describe("Search terms."), limit: z.number().describe("Max results.").optional() }),
+      annotations: READ_ONLY,
+    },
+    async (args) => {
+    try { return text(await m0_search(args)) } catch (e) { return textError(error(e)) }
+  }
+  )
+server.registerTool(
+    "artwork",
+    {
+      title: "Artwork",
+      description: "Details for one artwork.",
+      inputSchema: z.object( { id: z.number().describe("Artwork ID.") }),
+      annotations: READ_ONLY,
+    },
+    async (args) => {
+    try { return text(await m0_artwork(args)) } catch (e) { return textError(error(e)) }
+  }
+  )
+  return server
+}

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": [
+    "src/**/*"
+  ]
+}