mcpField
O
Omeka S MCP Sample

Omeka S MCP Sample

Local
github.com/nakamura196Files & Storage1Updated 73w ago
Repository

About Omeka S MCP Sample

Omeka S MCP Sample connects the Omeka S API with Claude Desktop through an MCP server. It supports item discovery and management, including media uploads from a file or URL.

Key features

  1. 01List items with pagination
  2. 02Retrieve item details
  3. 03Create items with metadata
  4. 04Upload media from files or URLs

Use cases

  1. 01Browse an Omeka S collection
  2. 02Retrieve an item's details
  3. 03Add items and metadata
  4. 04Attach media to an item

MCP support

The MCP server exposes Omeka S tools for listing, retrieving, and creating items, and uploading media. The README describes configuration for Claude Desktop.

#omeka#mcp#omeka-s#mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Omeka S MCP Sample

This project demonstrates how to integrate Omeka S API with Claude Desktop using MCP (Model Context Protocol).

The server provides the following Omeka S API features:

  • List items
  • Get item details
  • Create new items
  • Upload media (from file or URL)

Installation

  1. Clone this repository
  2. Install dependencies:
uv pip install -e .

Configuration

Create a .env file in the project root with your Omeka S API credentials:

OMEKA_API_URL=https://your-omeka-s-instance/api
OMEKA_KEY_IDENTITY=your-key-identity
OMEKA_KEY_CREDENTIAL=your-key-credential

Usage

Add the following settings to your Claude Desktop configuration file:

"mcpServers": {
    "omeka-s-mcp-sample": {
        "command": "python",
        "args": [
            "/path/to/omeka-s-mcp-sample/server/omeka_server.py"
        ]
    }
}

Note

If you receive a command not found error when launching the server, specify the full path to your Python executable.

Available Tools

The server provides the following MCP tools:

list-items

List items from Omeka S with pagination support.

get-item

Get details of a specific item by ID.

create-item

Create a new item with title and optional description.

upload-media

Upload media to an item either from a local file or URL.

Example Usage

You can ask Claude to:

  • List items from your Omeka S instance
  • Get details of a specific item
  • Create new items with metadata
  • Upload media files or URLs to items

Development

This project uses:

  • Python 3.10+
  • MCP 1.6.0+
  • aiohttp for API requests
  • Ruff for code formatting and linting

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.