smithsonian-mcp

[](https://badge.fury.io/js/%40molanojustin%2Fsmithsonian-mcp) [](https://www.npmjs.com/package/@molanojustin%2Fsmithsonian-mcp) [](https://hub.docker.com/r/justinmol/smithsonian-mcp)

A Model Context Protocol (MCP) server that provides AI assistants with access to the Smithsonian Institution's Open Access collections. This server allows AI tools like Claude Desktop to search, explore, and analyze over 3 million collection objects from America's national museums.

The npm package includes automatic Python dependency management and works across platforms:

# Install globally
npm install -g @molanojustin/smithsonian-mcp

# Or run directly with npx (no installation needed)
npx -y @molanojustin/smithsonian-mcp

# Set your API key
export SMITHSONIAN_API_KEY=your_key_here

# Start the server
smithsonian-mcp

The enhanced setup script now includes:

• ✅ API key validation - Tests your key before saving
• ✅ Service installation - Auto-install as system service
• ✅ Claude Desktop config - Automatic configuration
• ✅ Health checks - Verify everything works

macOS/Linux:

chmod +x config/setup.sh
config/setup.sh

Windows:

config\setup.ps1

1. Get API Key: api.data.gov/signup (free)
2. Install: uv pip install -r config/requirements.txt
3. Configure: Copy .env.example to .env and set your API key
4. Test: python examples/test-api-connection.py

Run the verification script to check your installati