Omeka S MCP Sample

What is Omeka S MCP Sample?

This project demonstrates how to integrate Omeka S API with Claude Desktop using MCP (Model Context Protocol). It provides tools to list items, get item details, create new items, and upload media to an Omeka S instance.

How to use Omeka S MCP Sample?

Clone the repository, install dependencies with uv pip install -e ., and create a .env file with Omeka S API credentials. Add the server configuration to your Claude Desktop mcpServers JSON, pointing to omeka_server.py and specifying the full Python path if needed.

Key features of Omeka S MCP Sample

• List items from Omeka S with pagination support
• Get details of a specific item by ID
• Create new items with title and description
• Upload media to items from local file or URL
• Integrated with Claude Desktop via MCP

Use cases of Omeka S MCP Sample

• Managing an Omeka S collection through natural language in Claude
• Quickly retrieving item details without logging into the Omeka S admin
• Automating metadata entry for new items
• Attaching media files or remote URLs to existing items

FAQ from Omeka S MCP Sample

What Python version and dependencies are required?

Python 3.10+ with MCP 1.6.0+, aiohttp, and optionally Ruff for development.

How do I set up Omeka S API credentials?

Create a .env file in the project root with OMEKA_API_URL, OMEKA_KEY_IDENTITY, and OMEKA_KEY_CREDENTIAL.

How do I configure the server in Claude Desktop?

Add an entry to mcpServers in your Claude Desktop config with "command": "python" and "args" pointing to the full path of omeka_server.py.

What tools does the server provide?

Four tools: list-items, get-item, create-item, and upload-media.