@dennisk2025/random-artwork-finder
v1.0.0
Published
Fetches information and images of random artworks from global art museums, providing art inspiration, facts, and artwork details.
Readme
Random Artwork Finder MCP Server\n\nFetches information and images of random artworks from global art museums, providing art inspiration, facts, and artwork details. This MCP server uses The Metropolitan Museum of Art (the Met) open API and exposes two tools: get a random artwork or search for artworks by keyword.\n\n## Installation\n\nInstall globally or run instantly with NPX:\n\n- Install:\n npm install -g @dennisk2025/random-artwork-finder\n\n- Or run with NPX:\n npx @dennisk2025/random-artwork-finder\n\n## Adding to Claude Desktop\n\nTo integrate this MCP server with Claude Desktop, add the following configuration to your Claude Desktop config file.\n\nConfig JSON:\n\njson\n{\n "mcpServers": {\n "random-artwork-finder": {\n "command": "npx",\n "args": ["@dennisk2025/random-artwork-finder"]\n }\n }\n}\n\n\nLocation:\n- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json\n- Windows: %APPDATA%\Claude\claude_desktop_config.json\n\nAdd this block under the "mcpServers" key (create it if missing) and restart Claude Desktop.\n\n## Usage\n\nThis MCP server provides the following tools:\n\n### 1. get_random_artwork\n- Description: Returns metadata and an image link for a randomly selected piece of artwork from the Metropolitan Museum of Art's collection.\n- Parameters: None\n\n#### Example call\njson\n{\n "tool": "get_random_artwork",\n "parameters": {}\n}\n\n\n### 2. search_artworks_by_keyword\n- Description: Searches for artworks whose titles or artist names match a given keyword, returning details on the top results.\n- Parameters:\n - keyword (string, required): The search term (e.g., "Monet", "sunflowers").\n\n#### Example call\njson\n{\n "tool": "search_artworks_by_keyword",\n "parameters": {\n "keyword": "van Gogh"\n }\n}\n\n\n## Tool Reference\n\n| Tool | Parameters | Description |
|-----------------------------|--------------------------------|-----------------------------------------------------------------------------| | get_random_artwork | none | Random artwork, with metadata and image | | search_artworks_by_keyword | keyword (string, required) | Search the Met's collection by keyword/title/artist (top results returned) | \nThe returned artwork metadata includes title, artist, year, medium, department, dimensions, repository, and direct image URLs when available.\n\n---\n\nHave fun exploring inspiring artworks from the Met!\n
