Omeka S MCP Sample
@nakamura196
This project demonstrates how to integrate Omeka S API with Claude Desktop using MCP (Model Context Protocol).
Overview
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.
