Skip to main content
Glama
anupta

Omeka MCP

by anupta
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Omeka MCP

A FastMCP server that connects AI assistants to an Omeka S collection through the Omeka REST API.

Features

  • Search Omeka items by text.

  • Fetch one item by numeric ID.

  • Return item metadata in a readable format.

  • Return public Omeka item page links instead of API links.

  • Support optional Omeka API credentials.

Related MCP server: mcp-smithsonian

Requirements

  • Python 3.10 or newer

  • An Omeka S REST API endpoint

Installation

Create and activate a virtual environment, then install the dependencies:

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt

Configuration

Edit config.ini:

[omeka]
items_url = http://<IP_Address>/omeka/api/items
site_url = http://<IP_Address>/omeka/s/terracotta/item/
api_key_identity =
api_key_credential =

items_url is used to retrieve records. site_url is used to create browser-facing item links. API credentials can be left empty when the Omeka API is public.

Do not commit real API credentials to source control.

Run

Run the MCP server with the default configuration:

python main.py

To use a different configuration file:

python main.py path\to\config.ini

MCP Tools

search_items

Search the Omeka collection.

Parameters:

  • query: Search text. Defaults to an empty string.

  • page: Page number, starting at 1. Defaults to 1.

  • limit: Number of results, from 1 to 100. Defaults to 10.

get_item

Fetch one Omeka item by its numeric ID.

Parameters:

  • item_id: The Omeka item ID.

Example Public Link

For item 131, the server returns:

http://<IP_Address>/omeka/s/terracotta/item/131

The Omeka API record itself is fetched from:

http://<IP_Address>/omeka/api/items/131

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Smithsonian Open Access MCP

    molanojustin
    A
    license
    A
    quality
    B
    maintenance
    Provides AI assistants with access to search, explore, and analyze over 3 million collection objects from the Smithsonian Institution's museums. Enables finding objects currently on exhibit, retrieving detailed metadata, high-resolution images, and 3D models from America's national museums.
    5
    34 npm
    10
    MIT

  • mcp-smithsonian

    pipeworx-io
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables searching and retrieving detailed information about items from the Smithsonian Open Access collection, including metadata and images.
    7 npm
    MIT

  • The Metropolitan Museum of Art

    pipeworx-io
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to search The Met's open-access collection by keyword with filters for images, on-view status, medium, and year range, and to fetch rich object details such as artist bio, dimensions, department, and gallery number. Also lists the museum's curatorial departments so searches can be scoped, all without an API key.
    14 npm
    1
    MIT

  • zotero-mcp

    nicholasmoreno637
    F
    license
    Not graded
    quality
    A
    maintenance
    Enables AI assistants to search a Zotero library by text query and retrieve complete item metadata or full-text PDF contents through the Zotero local or Web API. Tools can be chained sequentially, letting assistants find items and then pull their details or text content.
    -