Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

Source Library

von Embassy-of-the-Free-MindVersion 4.13.0i★ 30 (Sterne des ganzen Repos)iLäuft in der CloudOffizielle Website ↗
Name in der Registryio.github.Embassy-of-the-Free-Mind/sourcelibrary

So installierst du es

What it does

Search 15K rare pre-modern texts translated to English: philosophy, religion, science, literature.

  • Connects Läuft in der Cloud
  • Account or key No key needed
  • Category Spiele, Sport, Essen & Lernen

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit0/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch8/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert20/100

Qualität: 4/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte Source Library. Folge https://mcp.popnx.com/i/embassy-of-the-free-mind-sourcelibrary.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

4/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (sourcelibrary.org) · ✓ Befehle geprüft am 13. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 2 Min.

Kein Schlüssel, nichts zu installieren · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameSource Library
    Remote MCP server URL · Adressehttps://sourcelibrary.org/api/mcp

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  3. Im Chat einschalten

    +ConnectorsSource Library

  4. Ausprobieren

    Nutze Source Library und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es Source Library nutzt, oder ein Werkzeug von Source Library in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit ChatGPT je nach Tarif

Volles MCP: ChatGPT Business, Enterprise oder Edu im Web · Pro: verbindet mit Lese-/Abrufrechten, Werkzeuge, die Daten ändern, gehen evtl. nicht · Plus: in der Doku nicht bestätigt; siehst du auf der Plugins-Seite eine Option für eigene MCP-Server, kannst du es versuchen · nur Web

  1. In ChatGPT im Web die Seite zum Hinzufügen von MCP öffnen

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Name und Adresse eintragen

    Namen eingeben, Adresse unter Connection einfügen, Risikohinweis abhaken und Create as a plugin klicken

    Name · NameSource Library
    Connection · Adressehttps://sourcelibrary.org/api/mcp
  3. Source Library im Chat auswählen

    Neuen Chat öffnen und vor dem Tippen Source Library aus deinen Plugins wählen

  4. Ausprobieren

    Nutze Source Library und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn ChatGPT sagt, dass es Source Library nutzt, oder ein Werkzeug von Source Library in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von OpenAI abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Claude Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  2. Diesen Befehl einfügen und Enter drücken

    claude mcp add --transport http --scope user sourcelibrary https://sourcelibrary.org/api/mcp
  3. /mcp in Claude Code eingeben

    Source Library sollte in der Liste als verbunden erscheinen

  4. Ausprobieren

    Nutze Source Library und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es Source Library nutzt, oder ein Werkzeug von Source Library in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in Cursor im Agent-Modus öffnen

  3. Ausprobieren

    Nutze Source Library und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es Source Library nutzt, oder ein Werkzeug von Source Library in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in VS Code im Agent-Modus öffnen

  3. Ausprobieren

    Nutze Source Library und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es Source Library nutzt, oder ein Werkzeug von Source Library in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://sourcelibrary.org/api/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Source Library nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das Web

Claude Code

claude mcp add --transport http --scope user sourcelibrary https://sourcelibrary.org/api/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "sourcelibrary": {
      "url": "https://sourcelibrary.org/api/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "sourcelibrary": {
      "type": "http",
      "url": "https://sourcelibrary.org/api/mcp"
    }
  }
}

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

GitHub-Sternei
30 (Sterne des ganzen Repos)
Dieses Repo enthält mehrere MCP-Einträge; die Sterne zählen in Ranglisten nur einmal
Downloads pro Wochei
Nicht auf npm/PyPI
Lizenzi
AGPL-3.0
Verbindung
Läuft in der Cloud
Transport
streamable-http
Neueste Versioni
4.13.0
In der Registry veröffentlichti
6. Nov. 2026
Code zuletzt geänderti
18. Nov. 2026
Zuletzt geprüft
16. Nov. 2026
Entwickler
Embassy-of-the-Free-Mind
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Tool-Namen und -Beschreibungen genau so, wie der Server sie am 16. Nov. 2026 gemeldet hat. Geschrieben hat sie der Entwickler, nicht wir; wir zeigen sie als reinen Text.

  • search_library

    RETURNS A LIST OF BOOKS (works on a topic) — NOT passages. PICK THIS to discover which works exist on a subject. → For quotable text use search_translations (exact words) or search_concept (by meaning); if the user already named an author/work, call get_book directly (or list_boo

  • search_translations

    RETURNS QUOTABLE PASSAGES (page-level snippets + citation URLs), matched by KEYWORD/term. PICK THIS to find a quote or textual evidence on a topic across the whole library. → If the modern word won't literally appear in historical texts, use search_concept (matches by meaning); t

  • search_concept

    RETURNS QUOTABLE PASSAGES matched by MEANING (cosine similarity on Gemini embeddings, 768d) — paraphrases and adjacent phrasings match even with zero keyword overlap. PICK THIS when the modern term won't literally appear in historical texts — e.g. "distributed cognition" maps to

  • search_within_book

    SEARCHES INSIDE ONE BOOK (requires book_id). PRIMARILY KEYWORD: it runs a lexical search over the book's pages plus a narrow scoped-semantic pass (top ~10), interleaved by relevance. PICK THIS when you know the wording you are looking for, or want every page of one book mentionin

  • list_books

    BROWSES/FILTERS THE CATALOG by metadata (canonical author via author_id, title/author/summary words via search, language, category, year range, translation recency) — no page-text matching. PICK THIS to see WHAT EXISTS by an author or in a tradition, or to enumerate a date range.

  • get_book

    READ PIPELINE step 1 — DISCOVER. START HERE for any named work or author. Returns the book's AI-generated summary, chapter list, edition metadata, first_translation (the site's First Translation badge: badge_shown, badge_label, claim confirmed|candidate|defeated|not_applicable, t

  • get_book_text

    READ PIPELINE step 2 — READ. Read a book's text. Call get_book first (step 1) for the chapter list, then come here. Preferred: use the chapter param to read one chapter at a time (includes [Page N] markers for citation). Alternatively, use from/to for explicit page ranges (e.g. f

  • get_quote

    READ PIPELINE step 3 — CITE. Get the exact verbatim text of a single page plus its citation apparatus. ALWAYS use before putting text in quotation marks. The response headline is citation_link (the stable sourcelibrary.org/q/… shortlink) — present it to the user alongside the quo

  • list_editions

    Every edition of one work that the library holds — the other witnesses to the same text, across languages and centuries. Give it a book_id (easiest: the id of any edition you already found) or a work_id. USE THIS when a quotation needs checking against more than one witness, when

  • check_duplicate

    DOES THE LIBRARY HOLD THIS WORK? Call this BEFORE telling the user the library lacks a book, and before proposing one for acquisition. A miss from list_books or search_library is NOT evidence of absence: list_books matches words and search_library ranks by relevance, so a held bo

  • get_quotes

    READ PIPELINE step 3 — CITE, in batch. Get verbatim text + citation_link for SEVERAL pages of a single book in one round-trip, to assemble a multi-passage dossier. Specify either pages (an explicit array, e.g. [12, 40, 41]) or an inclusive from/to range. Max 25 pages per call. Ea

  • search_images Sieht aus wie eine Anweisung an die KI

    Search 200,000+ historical illustrations, emblems, engravings, diagrams, AND 24,000+ artworks (paintings, prints, sculptures). Filter by type, subject, figure, symbol, year. Results interleave two collections: illustrations extracted from book pages (each with a page number and b

  • list_image_facets

    List the legal values of search_images' type, subject, figure and symbol filters, with how many images carry each. Those filters are EXACT string matches on tags an AI extractor wrote, and each vocabulary runs to thousands of strings (e.g. "musical notes", "Jesus Christ", "medici

  • submit_feedback

    Submit feedback, bug reports, or feature requests to the Source Library team. Before proposing NEW functionality, read https://sourcelibrary.org/llms.txt and https://sourcelibrary.org/developers — several past submissions proposed building things that already exist (IIIF manifest

  • share_findings

    Share a research dossier back to the Source Library team — a title, an optional summary, and an ordered list of citations (the passages your thesis rests on). Each citation is a reference { book_id, page, note }, NOT copied text: the library re-renders the canonical quote from th

  • propose_collection

    Propose a themed collection of books to the Source Library team — a title, a rationale (why these books belong together and what thread connects them), and an ordered list of book ids. Get book ids from search_library / list_books / get_book. Like submit_feedback and share_findin

  • start_review_shift

    Start a volunteer REVIEW SHIFT: the user lends their Claude (you) to Source Library to check one book against its scans: by default its 10-page check, two facing pages from each fifth of the book, then reading on in order if the user wants. Use when the user wants to help Source

  • continue_review_shift

    Next page of the book being reviewed. Call it straight after finishing a page until the check or the stretch the user chose is done, and again when they ask for more. Pass every field of next from the previous page (book, plan, and step or after), and volunteer_code. Returns the

  • start_blind_check

    OPTIONAL lane, only for a user who reads the original language and asks to judge pages themselves: up to five random pages from different books, each with scan, transcription and English. Here the USER is the reviewer: ask for THEIR verdict first, before any opinion of yours, the

  • submit_page_review

    Record the verdict on one page of a shift. mode "book-run" (start_review_shift / continue_review_shift): the verdict and findings are YOURS, from reading the scan and both texts; set user_looked true if the user checked anything on the page themselves. mode "blind" (start_blind_c

  • propose_correction

    During a review shift, propose a correction to a page's transcription (field "ocr") or English (field "translation"). A correction is a list of exact span edits: each "find" must be copied exactly from the text the shift returned and occur once on the page (add surrounding words

  • get_locus

    Turn a CANONICAL CITATION into the actual leaves that carry it. Aristotle is cited by Bekker number (1094a8, 1447a) and Plato by Stephanus number (Rep. 328b) — the references scholarship has used for centuries, which survive re-typesetting and are shareable in a way a scan page n

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto Embassy-of-the-Free-Mind bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: gestern

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt AGPL-3.0

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 751 ms (HTTP 200)

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Keine Anmeldung nötig

  • ✕ Nicht bestanden

    Keine versteckten Anweisungen in Tool-Beschreibungen

    1 Tool-Beschreibungen enthalten Text, der wie Anweisungen an die KI aussieht. Lies sie unten, bevor du installierst

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/embassy-of-the-free-mind-sourcelibrary.svg)](https://mcp.popnx.com/en/servers/embassy-of-the-free-mind-sourcelibrary)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Spiele, Sport, Essen & Lerneni

  • Mehr Sterne als 0 % der anderen 1614 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 67 % der anderen 1614 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 64 % der anderen 1614 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Source Library sicher?

Er hat 4 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Er läuft in der Cloud des Entwicklers. Du verbindest dich übers Internet, ohne etwas zu installieren, aber was du sendest, läuft über die Server des Entwicklers.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt gestern geändert, und die neueste Version (4.13.0) kam vor 13 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: Anime Garden, WilmAI, Lumify Sports Intelligence, Savecraft, GoodWatch

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Anime Garden

Anime Garden MCP for anime torrent discovery.

von yjl9903Wachsend★ 1412Aktualisiert vor 15 Tagen

Läuft in der Cloud✓ animes.garden

WilmAI

Finland's Wilma school system for parents and students: schedule, homework, exams and messages.

von aikarjalWachsend↓ 1399/Wo.★ 89 Sterne des ganzen ReposAktualisiert vor 10 Tagen

Läuft auf deinem Computer✓ vom Dienst · wilm.ai

Lumify Sports Intelligence

Schedules, scores, odds, splits & explainable AI bet confidence — 8+ sports, free instant key.

von lumifyaiAm Anfang★ 15Aktualisiert vor 4 Monaten

Läuft in der Cloud✓ vom Dienst · lumify.ai

Savecraft

Savecraft serves real save game data and expert game knowledge to AI assistants.

von joshsymondsAm Anfang★ 13Aktualisiert vor 7 Monaten

Läuft in der CloudRepo archiviert✓ vom Dienst · savecraft.gg

GoodWatch

Find movies and TV shows, track watches, and get suggestions based on your taste.

von alp82Am Anfang★ 50 Sterne des ganzen ReposAktualisiert vor 30 Tagen

Läuft in der Cloud✓ vom Dienst · goodwatch.app
Im Vergleich mit ähnlichen
Dieser
Source Library
Anime GardenWilmAILumify Sports IntelligenceSavecraftGoodWatch
Läuft woLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationWird auf deinem Rechner installiertLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselNeinNeinNeinJaNeinNein
Mit + in Claude hinzufügenNeinNeinNeinNeinNeinNein
Basisprüfungen4/54/43/34/43/44/4
LizenzAGPL-3.0AGPL-3.0MITMITApache-2.0MIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

Source Library

A digital library of historical primary sources with AI-aided OCR, translation, and scholarly curation.

🌐 Visit Library • 📖 Docs • 🗺️ System Map • 🤝 Contribute


🎬 Experience Source Library

Your browser does not support the video tag.

*Explore thousands of digitized historical texts with AI-enhanced translations and scholarly curation.*


🎯 About Source Library

Source Library is an open digital library dedicated to making early printed books and primary sources readable and citable. We specialize in alchemy, Hermetica, Kabbalah, Rosicrucianism, and early modern science—texts that bridge historical scholarship with contemporary exploration.

🌟 Why Source Library?
  • ✨ Originals First — Read the original language text with AI-enhanced translations alongside
  • 🎓 Citable Scholarship — Every book gets a DOI and scholarly metadata (USTC alignment, edition tracking)
  • 🏛️ Partner Subdomains — Institutions like the Bibliotheca Philosophica Hermetica curate reading rooms on their own domains
  • 🔍 Discovery — Collections, galleries of illustrations, and semantic search surface overlooked texts
  • ✅ Rigorous QA — Manual verification, image quality scoring, and OCR validation before publication

The platform ingests ~15K pages monthly from Internet Archive, Gallica, Bodleian, Wellcome, and other digital heritage partners.


🚀 Quick Start

💻 Development Environment
# 🍴 Clone and install

git clone https://github.com/Embassy-of-the-Free-Mind/sourcelibrary-v2.git cd sourcelibrary-v2 npm install

⚙️ Configure environment (see .env.example for required variables)

Must include: MongoDB Atlas connection, Google Gemini API key, Vercel Blob token

▶️ Start dev server

npm run dev

Open http://localhost:3000


📋 Tech Stack

🎨 Frontend Next.js 16, React 19, TailwindCSS, Lucide icons

⚙️ Backend Next.js API routes, AWS Lambda for async processing

💾 Database MongoDB Atlas (primary), Supabase (embeddings)

🤖 AI/ML Google Gemini 3.1 (OCR, translation, summarization)

🗂️ Storage Vercel Blob (images), AWS S3 (archive), Cloudflare R2 (archive)

🔐 Auth NextAuth v5 with MongoDB adapter

🚀 DevOps Vercel (hosting), GitHub (VCS), Playwright (E2E tests)

✔️ Testing Vitest (unit/integration), Playwright (E2E)

🔎 Search PostgreSQL FTS + semantic search via Supabase

📦 Key Dependencies:

  • sharp — Image resizing and cropping
  • @google/generative-ai — Gemini API integration
  • xml2js — USTC metadata parsing
  • @modelcontextprotocol/sdk — MCP server for agent integration
  • stripe — Donation and subscription handling

📚 Core Features

📖 Reading & Navigation
  • ⚡ Page pagination — Instant navigation between 100+ pages
  • 🔍 Full-text search — Query across OCR'd text and translations
  • 📌 Quote generation — Copy and cite passages with DOI links
🔄 Processing Pipeline
  • 🧩 Smart split detection — Automatic gutter detection for two-page spreads (Gemini AI or ML-based)
  • ✍️ High-accuracy OCR — Gemini Vision API with language-specific models (Latin, German, Greek, Arabic, etc.)
  • 🗣️ Context-aware translation — Maintains continuity across pages for scholarly accuracy
  • 🖼️ Gallery extraction — AI-powered detection and cataloging of illustrations
🎨 Curation & Discovery
  • 📑 Themed collections — Editorial collections (e.g., "Alchemy & Transmutation," "Kabbalah & Mysticism")
  • 🏛️ Gallery browsing — Curated images from all books (museum-quality metadata)
  • 📚 Related editions — Link across translations, reprints, and derivative works
  • 🔗 Authority linking — Connect to USTC, VIAF, and other scholarly databases
📤 Scholarly Export
  • 📱 EPUB generation — Multi-format ebook export
  • 📄 PDF with annotations — Preserve layout, add scholarly notes
  • 🆔 DOI minting — Version books via Zenodo integration for long-term citation
🏢 Tenant Subdomains
  • 🏛️ Isolated reading rooms — Partners host curated subsets on custom domains (e.g., bph.sourcelibrary.org)
  • 🎨 Branding & navigation — Full UI customization per tenant
  • 🔒 Access control — Public or members-only collections

🏗️ Architecture Overview

📊 Data Model

📚 Books contain structured metadata:

  • 🏛️ Bibliographic — Title, author, language, publication date, USTC ID
  • 🖼️ Images — Links to source (Internet Archive, Gallica, etc.), archival status
  • ⚙️ Processing — OCR status, translation language, extraction metadata
  • 🎨 Curation — Collections, tier (featured/standard), visibility flags

📄 Pages store individual page data:

  • 📸 Original image — Source photo or PDF page
  • ✂️ Split coordinates — Crop boundaries (0-1000 scale) for two-page spreads
  • ✍️ OCR output — Raw Gemini extraction + language metadata
  • 🗣️ Translation — English translation with scholarly notes
  • 🖼️ Illustrations — Detected images with quality scores and descriptions

🖼️ Gallery images are extracted illustrations:

  • 🏷️ Metadata — Subject, figures, symbols, style, techniques, period
  • ⭐ Quality score — 0–1.0 rating (filters below 0.5)
  • 🔗 Provenance — Source book and page, linked back
🎨 Image Tier System

All page images are resized on-demand via /api/image:

TierDimensionsQuality📱 Use Case
Thumbnail400px wide70% JPEGGrids, navigation, social sharing
Display1200px wide80% JPEGMain reading view, comfortable for annotation
Full2400px wide90% JPEGMagnifier, fullscreen detail, printing

Split pages are cropped non-destructively via coordinates; original images are always preserved.

🔄 Processing Pipeline
📥 Import → ✂️ Split Detection → ✍️ OCR → 🗣️ Translation → 🎨 Enrichment → 🌍 Publishing
  1. 📥 Import — Upload images, import from IA/Gallica via IIIF, or paste URLs
  2. ✂️ Split Detection — Detect two-page spreads; mark crop boundaries
  3. ✍️ OCR — Gemini Vision extracts text per page language
  4. 🗣️ Translation — Gemini translates to English with prior-page context for continuity
  5. 🎨 Enrichment — Extract illustrations, generate summaries, assign collections
  6. 🌍 Publishing — Set visible: true, mint DOI, push to search index

Batch endpoints process up to 5 pages/request using Gemini Batch API (50% cheaper).

🔌 API Routes (Key)

Base URL: https://sourcelibrary.org (production) or http://localhost:3000 (local dev with .env.local configured).

Common 404 mistake: paths like /api/bph/books or /api/bph/books/[id] do not exist. BPH catalogue APIs live under /api/embed/bph/.... There is also no top-level /api/[tenant]/books route — tenant book listings use /api/books/library or the embed routes below.

Public read APIs (no auth required today)
EndpointMethodPurpose
/api/search?q= GETFull-text search across books and page translations
/api/books?limit=100&offset=0GETSimple book list (global catalogue; visible: true, indexed only)
/api/books/library?limit=100&skip=0GETRich browse API — search, sort, filters, collections
/api/books/[id]GETBook metadata (accepts Mongo id or slug)
/api/books/[id]/quote?page= GETCitable quote + formatted citations (inline, footnote, BibTeX, DOI)
/api/gallery?limit=24GETIllustration / artwork search
/api/image?url= &w=400GETOn-demand image resize & crop
/api/embed/bph/books?limit=24GETBPH catalogue (paginated, searchable)
/api/embed/bph/books/[slug]GETSingle BPH book detail
/api/embed/bph/featuredGETFeatured BPH books
/api/embed/bph/collectionsGETBPH collection list
/api/embed/bph/languagesGETBPH language facets
/api/embed/bph/suggest?q=alchGETBPH search autocomplete
/api/embed/bph/statsGETBPH catalogue stats
Tenant-scoped listing (not /api/bph/...)

Use one of these patterns to filter by partner tenant (e.g. BPH):

ApproachExample
Embed prefix (recommended for BPH)GET /api/embed/bph/books?limit=24
Library API + query paramGET /api/books/library?tenant_slug=bph&limit=24
Host header (subdomain)Call https://bph.sourcelibrary.org/api/books/library?limit=24 — the proxy injects tenant context
Manual header (advanced)curl -H "x-tenant-slug: bph" https://sourcelibrary.org/api/books/library?limit=24

The /api/[tenant]/books/[id]/... paths that exist in the codebase are editor/processing routes (batch OCR, index rebuild, etc.) — not public catalogue listings.

Authenticated / internal APIs

These require a signed-in session cookie, editor role, or (for some dataset endpoints) a Bearer API key. Calling them without auth returns 401 or 403.

EndpointMethodPurpose
/api/booksPOSTCreate a new book (editor)
/api/books/[id]PATCHUpdate book metadata (curator+)
/api/pages/[id]PATCHUpdate page OCR/translation
/api/jobs/[id]/processPOSTAsync job processor (Lambda)

Full narrative API walkthrough: docs/blog-source-library-api.md. MCP tools (search, quote, read): mcp-server/README.md.

🧪 Trying the API (curl, Postman, browser)

All examples below hit production and need no API key. Replace the base URL with http://localhost:3000 when running locally (MongoDB + env vars required).

curl
# Search translated text

curl -s "https://sourcelibrary.org/api/search?q=quintessence&limit=5" | jq .

List books (global catalogue)

curl -s "https://sourcelibrary.org/api/books?limit=5" | jq .

Browse with filters and sort

curl -s "https://sourcelibrary.org/api/books/library?limit=5&sort=recent-translation&has_translation=true" | jq .

BPH catalogue — note /api/embed/bph/, NOT /api/bph/

curl -s "https://sourcelibrary.org/api/embed/bph/books?limit=5&translated=true" | jq .

BPH via tenant_slug on the library endpoint

curl -s "https://sourcelibrary.org/api/books/library?tenant_slug=bph&limit=5" | jq .

Book metadata (id or slu

Nur der Anfang wird gezeigt; den Rest findest du im Repo