MCP

🚀 Cultural Heritage MCP Server

A Model Context Protocol (MCP) server offering access to European cultural heritage collections and artworks.

🚀 Quick Start

The Cultural Heritage MCP Server is a powerful tool that allows users to access European cultural heritage collections and artworks. It provides various features and tools to facilitate the exploration of cultural heritage.

✨ Features

• Search Functionality: Search for cultural heritage items by artist, title, type, or description.
• Detailed Information: Retrieve detailed information about specific artworks.
• Collection Browsing: Browse collections by cultural institution.
• AI - Powered Recommendations: Receive personalized recommendations based on user interests.
• Access to Famous Artworks: Gain access to famous artworks from major European museums.

📦 Installation

1. Install the required dependencies:

pip install -r requirements.txt

2. Start the server:

python server.py

💻 Usage Examples

Basic Usage

# Search for cultural heritage items
from server import search_cultural_heritage
results = search_cultural_heritage(query="Van Gogh", limit=3)
print(results)

# Get details of a specific artwork
from server import get_artwork_details
artwork_info = get_artwork_details(artwork_id="1")
print(artwork_info)

# Get artworks from a specific institution
from server import get_collections_by_institution
institution_artworks = get_collections_by_institution(institution_name="Louvre")
print(institution_artworks)

# Get cultural recommendations
from server import get_cultural_recommendations
recommendations = get_cultural_recommendations(user_interest="modern art")
print(recommendations)

Advanced Usage

# You can combine multiple operations for more complex exploration
from server import search_cultural_heritage, get_artwork_details
search_results = search_cultural_heritage(query="renaissance", limit=2)
for result in search_results:
    artwork_id = result['id']
    details = get_artwork_details(artwork_id)
    print(details)

📚 Documentation

Available Tools

search_cultural_heritage(query: str, limit: int = 5)

Search for cultural heritage items from European institutions.

Parameters:

• query: The search term (e.g., artist name, artwork title, type).
• limit: The maximum number of results to return (default is 5).

Returns:

• A formatted list of cultural heritage items with detailed information.

get_artwork_details(artwork_id: str)

Retrieve detailed information about a specific artwork.

Parameters:

• artwork_id: The unique identifier of the artwork.

Returns:

• Detailed information about the artwork, including description, provenance, and technical details.

get_collections_by_institution(institution_name: str)

Get artworks from a specific museum or cultural institution.

Parameters:

• institution_name: The name of the cultural institution (e.g., "Louvre", "British Museum").

Returns:

• A list of cultural items from the specified institution.

get_cultural_recommendations(user_interest: str)

Get AI - powered recommendations based on user interests.

Parameters:

• user_interest: The user's cultural interests (e.g., "modern art", "renaissance", "impressionist").

Returns:

• Personalized recommendations for cultural heritage exploration.

Sample Data

The server includes famous artworks from major institutions:

• The Starry Night (Van Gogh) - Museum of Modern Art
• Mona Lisa (Leonardo da Vinci) - Louvre Museum
• The Great Wave off Kanagawa (Hokusai) - British Museum
• Girl with a Pearl Earring (Vermeer) - Mauritshuis
• The Persistence of Memory (Dalí) - Museum of Modern Art
• The Birth of Venus (Botticelli) - Uffizi Gallery

🔧 API Integration

This MCP server can be extended to integrate with:

• Europeana API (European cultural heritage)
• Museum APIs (Rijksmuseum, Met Museum, etc.)
• Digital library collections
• Archaeological databases