Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

Source Library

de Embassy-of-the-Free-Mindversión 4.13.0i★ 30 (Estrellas de todo el repositorio)iSe ejecuta en la nubeSitio oficial ↗
Nombre en el registroio.github.Embassy-of-the-Free-Mind/sourcelibrary

Cómo instalar

What it does

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

  • Connects Se ejecuta en la nube
  • Account or key No key needed
  • Category Juegos, deportes, comida y aprendizaje

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad0/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo8/8El endpoint en la nube respondió en la última revisión
Puntuación de uso20/100

Calidad: Pasó 4/5 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala Source Library. Sigue https://mcp.popnx.com/i/embassy-of-the-free-mind-sourcelibrary.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 4/5 revisiones · Lo que preguntas pasa por el servidor del autor (sourcelibrary.org) · ✓ Comandos revisados el 13 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude · unos 2 min

Sin clave y sin instalar nada · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner

  1. Abre la página Connectors de Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Pulsa “Add” → “Custom” → “Web” y completa estos 2 campos

    Copia cada valor al campo con el mismo nombre en Claude y pulsa Continue

    Name · NombreSource Library
    Remote MCP server URL · Direcciónhttps://sourcelibrary.org/api/mcp

    Pulsa Continue en la pantalla de inicio de sesión que detectó Claude · en Authentication elige lo que indique el autor (Sign in now, Sign in when needed o No sign in) y pulsa Add

  3. Actívalo en un chat

    +ConnectorsSource Library

  4. Pruébalo

    Usa Source Library y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Source Library o muestra una herramienta de Source Library en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con ChatGPT según tu plan

MCP completo: ChatGPT Business, Enterprise o Edu en la web · Pro: conecta con permisos de lectura/obtención, así que las herramientas que cambian datos pueden no funcionar · Plus: no confirmado en la documentación; si ves una opción para añadir MCP propio en la página de plugins puedes probar · solo web

  1. Abre la página para añadir MCP en ChatGPT web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Escribe el nombre y la dirección

    Pon un nombre, pega la dirección en Connection, marca el aviso de riesgo y pulsa Create as a plugin

    Name · NombreSource Library
    Connection · Direcciónhttps://sourcelibrary.org/api/mcp
  3. Elige Source Library en un chat

    Abre un chat nuevo y elige Source Library en tus plugins antes de escribir

  4. Pruébalo

    Usa Source Library y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si ChatGPT dice que está usando Source Library o muestra una herramienta de Source Library en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de OpenAI el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Claude Code · unos 2 min

Sin clave y sin instalar nada

  1. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  2. Pega este comando y pulsa Enter

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

    Deberías ver Source Library en la lista como conectado

  4. Pruébalo

    Usa Source Library y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Source Library o muestra una herramienta de Source Library en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de Cursor en modo Agent

  3. Pruébalo

    Usa Source Library y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Source Library o muestra una herramienta de Source Library en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de VS Code en modo Agent

  3. Pruébalo

    Usa Source Library y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Source Library o muestra una herramienta de Source Library en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

Dirección para apps que se conectan por la web

Direcciónhttps://sourcelibrary.org/api/mcp

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Source Library💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Por la 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"
    }
  }
}

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Estrellas de GitHubi
30 (Estrellas de todo el repositorio)
Este repositorio tiene varias fichas MCP; sus estrellas cuentan una sola vez en las clasificaciones
Descargas por semanai
No está en npm/PyPI
Licenciai
AGPL-3.0
Conexión
Se ejecuta en la nube
Transporte
streamable-http
Última versióni
4.13.0
Publicado en el registroi
6 nov 2026
Último cambio de códigoi
18 nov 2026
Última revisión
16 nov 2026
Creador
Embassy-of-the-Free-Mind
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se conectan por internet en

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

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Nombres y descripciones de las herramientas tal como los informó el servidor el 16 nov 2026. Los escribió el creador, no nosotros; los mostramos como texto sin formato.

  • 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 Parece una instrucción para la IA

    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

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub Embassy-of-the-Free-Mind, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: ayer

  • ✓ Superada

    Tiene licencia

    Usa AGPL-3.0

  • ✓ Superada

    El endpoint responde

    Respondió en 751 ms (HTTP 200)

  • – No aplica

    Inicio de sesión con OAuth

    No hace falta iniciar sesión

  • ✕ No superada

    Sin instrucciones ocultas en las descripciones de herramientas

    1 descripciones de herramientas contienen texto que parece dar instrucciones a la IA. Léelas abajo antes de instalar

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![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)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Juegos, deportes, comida y aprendizajei

  • Más estrellas que el 0% de los otros 1619 servidores de esta categoría
  • Publicado en el registro más recientemente que el 67% de los otros 1619 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 64% de los otros 1619 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Source Library?

Superó 4 de 5 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en la nube del creador. Te conectas por internet sin instalar nada, pero lo que envías pasa por los servidores del creador.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez ayer, y la última versión (4.13.0) llegó al registro hace 13 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).

¿Qué puedo usar en su lugar?

En la misma categoría: Anime Garden, WilmAI, Lumify Sports Intelligence, Savecraft, GoodWatch

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Anime Garden

Anime Garden MCP for anime torrent discovery.

de yjl9903En crecimiento★ 1,4 milActualizado hace 15 días

Se ejecuta en la nube✓ animes.garden

WilmAI

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

de aikarjalEn crecimiento↓ 1,4 mil/sem★ 89 Estrellas de todo el repositorioActualizado hace 10 días

Se ejecuta en tu computadora✓ del servicio · wilm.ai

Savecraft

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

de joshsymondsInicial★ 13Actualizado hace 7 meses

Se ejecuta en la nubeRepo archivado✓ del servicio · savecraft.gg

GoodWatch

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

de alp82Inicial★ 50 Estrellas de todo el repositorioActualizado hace 30 días

Se ejecuta en la nube✓ del servicio · goodwatch.app
Comparado con otros parecidos
Este
Source Library
Anime GardenWilmAILumify Sports IntelligenceSavecraftGoodWatch
Dónde se ejecutaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaSe instala en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveNoNoNoSíNoNo
Se añade con + en ClaudeNoNoNoNoNoNo
Revisiones básicas4/54/43/34/43/44/4
LicenciaAGPL-3.0AGPL-3.0MITMITApache-2.0MIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

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

Solo se muestra el principio; lee el resto en el repo