IIIF

IIIF

IIIF MCP Server providing search, metadata, and image operations for IIIF resources.

0
Stars
0
Forks
1
Releases

Overview

IIIF MCP Server is a Model Context Protocol implementation for IIIF-based digital collections. It delivers core MCP capabilities for working with IIIF resources, including content search via the IIIF Content Search API, manifest and collection metadata retrieval via the IIIF Presentation API (v2/v3), and image operations through the IIIF Image API with parameter validation and image info support. The v1.1.0 release adds extended image data access by fetching actual image content as Base64 under automatic size constraints (max 1500px, 1M pixels) and enhanced canvas navigation that lists canvases with filtering and detailed information, including multi-image canvases. It also supports single-file bundling for npm-free deployment. The server references structured output support to facilitate programmatic integration with other MCP servers and tools. It adheres to IIIF specifications (Image API 3.0, Presentation API 3.0, Content Search API 2.0, Change Discovery 1.0, Auth 2.0, Content State 1.0). Authentication support covers cookie- and token-based flows, with guidance and testing via the IIIF Auth Demonstrator. Usage examples cover searching, manifest retrieval, image regioning, and structured data workflows.

Details

Owner
code4history
Language
JavaScript
License
MIT License
Updated
2025-12-07

Features

Search

Content Search API integration enabling full-text search within IIIF resources; supports v0, v1, and v2; tested with NC State IIIF collections and deployed to Claude Desktop.

Metadata Retrieval

Manifest and collection metadata retrieval via IIIF Presentation API (v2/v3); supports flexible property selection, multilingual labels, and complex HTML or nested metadata.

Image Operations

IIIF Image API support for building image URLs with region/size/rotation/quality/format; parameter validation; image info retrieval for v2/v3; comprehensive error handling.

Fetch Image Data (Base64)

Retrieve actual image content as Base64 with IIIF Image API parameter support; automatic size constraints (max 1500px, 1M pixels) and region extraction via percentage coordinates.

Canvas Navigation

Extended manifest exploration: list canvases with filtering options; detailed canvas information; supports multi-image canvases.

List Collections (Planned)

Retrieve all available collections with IIIF v2/v3 support; hierarchical navigation of nested collections and detailed listings of sub-collections and manifests.

Authentication & Access Control

Full IIIF Authorization Flow API implementation; cookie- and token-based authentication; external authentication; session management; probe/logout; compatible with IIIF Auth Demonstrator.

Media Processing

AV content and media information: extract A/V items from manifests, provide duration/dimensions; include chapter/range navigation for time-based content.

Tags

IIIFMCPImage APIPresentation APIContent Search APIChange DiscoveryIIIF AuthAnnotationsA/VCollections & ManifestsStructured OutputMultilingual Metadata