Skip to main content
Glama
Sign In
zengdard

Scroll MCP Server

by zengdard
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Scroll MCP Server v0.2

🎯 Vesuvius Challenge submission — Automated quality audit & corpus navigation for the Herculaneum scrolls.

MCP Server for the Vesuvius Challenge papyrological corpus & open data.

Exposes scroll metadata, transcriptions, CT volumes, ML models, and documentation via the Model Context Protocol.

Quick Start

pip install scroll-mcp-server
scroll-mcp-server

Or with Claude Desktop — add to your claude_desktop_config.json:

{
  "mcpServers": {
    "scroll": {
      "command": "scroll-mcp-server"
    }
  }
}

Related MCP server: IIIF MCP Server

URI Scheme

scroll://                    → Root
├── catalog/scrolls          → Scroll inventory
├── catalog/vocabulary       → Papyrological glossary
├── scroll/{id}/metadata     → Scroll metadata
├── scroll/{id}/transcriptions → Deciphered text
├── scroll/{id}/volumes      → CT scan info
├── model/ink-detection      → ML models
├── docs/tutorials           → Tutorials
├── docs/formats/tifxyz      → Format specs
└── docs/open-problems       → Research challenges

Tools

Tool

Description

search_corpus

Search transcriptions & metadata

get_scroll_catalog

Filtered scroll inventory

get_segment_data

Segment metadata + download links

get_tutorial

Tutorial content

get_format_spec

Technical format specification

get_model_info

ML model metadata

list_available_models

Filtered model list

Prompts

Prompt

Purpose

explain_papyrus_context

Historical/philosophical context of a passage

suggest_research_direction

Research recommendations from corpus state

Architecture

Client → FastMCP → ScrollDataLayer → Catalog (JSON) + Vesuvius (streaming) + Cache (LRU)

  • Catalogue JSON — Lightweight index (~50 KB) for instant metadata responses

  • Data Layer — Orchestrator with LRU cache, routes to the right source

  • Vesuvius Client — Streaming proxy for CT volumes (no local storage)

Development

git clone https://github.com/zengdard/scroll-mcp-server
cd scroll-mcp-server
pip install -e .
pytest tests/ -v

Real Example — Scroll 1 Segment Audit

Un exemple complet avec données réelles du Scroll 1 (PHerc. Paris 4) est dans examples/ :

# Audit du mesh noisy (84k vertices) contre le volume CT
python examples/audit_demo.py --quick

Résultat :

Quality score:    0.431  ← mesh bruité, besoin de raffinement
Mean confidence:  0.942  ← bonne qualité CT
Mean distance:    3.88 voxels
🔴 CRITIQUE — 55650 vertices en drift
🟢 ANCRE — 6418 vertices stables

Voir le rapport complet : examples/AUDIT_REPORT.md

Submission

Ce projet est soumis au Scroll Prize. Voir SUBMISSION.md pour les détails.

License

MIT

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

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • scholar-toolkit-mcp

    czwziy
    A
    license
    A
    quality
    C
    maintenance
    Comprehensive MCP server for academic research workflows, enabling paper searching across multiple sources, manuscript processing with citation placeholders, search caching, and citation export.
    11
    MIT

  • transkribus-mcp-server

    lazyants
    A
    license
    C
    quality
    A
    maintenance
    MCP server for the Transkribus REST API. Manage collections, documents, HTR/OCR recognition, models, and more through the Model Context Protocol.
    304
    47 npm
    2
    Functional Source , Version 1.1, MIT Future

  • nmlp-mcp

    joshseane
    A
    license
    A
    quality
    B
    maintenance
    Hosted MCP server for antiquarian first-edition identification and New Mexico book-donation logistics. 12 tools over a CC-BY, DOI-cited dataset of 6,700+ titles and 870 publisher conventions.
    12
    MIT