プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Source Library

作者:Embassy-of-the-Free-Mindバージョン 4.13.0i★ 30 (リポジトリ全体のスター)iクラウドで動く公式サイト ↗
レジストリ名io.github.Embassy-of-the-Free-Mind/sourcelibrary

インストール方法

What it does

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

  • Connects クラウドで動く
  • Account or key No key needed
  • Category ゲーム・スポーツ・料理・学習

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気0/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中8/8前回の確認でクラウドのエンドポイントが応答
利用スコア20/100

品質: 基本チェック 4/5 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Source Library をインストールして。https://mcp.popnx.com/i/embassy-of-the-free-mind-sourcelibrary.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 4/5 合格 · 質問内容は提供元のサーバー(sourcelibrary.org)を通ります · ✓ コマンド確認済み 2026年11月13日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげます · 約 2 分

キー不要、インストール不要 · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加

  1. Claude の Connectors ページを開く

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. 「Add」→「Custom」→「Web」を押し、この 2 つを入力

    ここからコピーして Claude の同じ名前の欄に貼り付け、Continue を押します

    Name · 名前Source Library
    Remote MCP server URL · アドレスhttps://sourcelibrary.org/api/mcp

    Claude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します

  3. チャットで有効にする

    +ConnectorsSource Library

  4. 試してみる

    Source Library を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Source Library を使っていると言うか、回答に Source Library のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT との接続はプランしだい

フル MCP:Web 版 ChatGPT の Business・Enterprise・Edu · Pro:読み取り/取得の権限で接続、データを変えるツールは使えないことがあります · Plus:公式ドキュメントで未確認。プラグイン画面にカスタム MCP を追加する項目があれば試せます · Web のみ

  1. Web 版 ChatGPT で MCP の追加ページを開く

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. 名前とアドレスを入力

    名前を入れ、Connection にアドレスを貼り付け、注意事項にチェックして Create as a plugin を押します

    Name · 名前Source Library
    Connection · アドレスhttps://sourcelibrary.org/api/mcp
  3. チャットで Source Library を選ぶ

    新しいチャットを開き、入力前にプラグインの一覧から Source Library を選びます

  4. 試してみる

    Source Library を使って、私に何ができるか教えて、1 つやってみせて

    ✓ ChatGPT が Source Library を使っていると言うか、回答に Source Library のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に OpenAI のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Claude Code につなげます · 約 2 分

キー不要、インストール不要

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  2. このコマンドを貼り付けて Enter

    claude mcp add --transport http --scope user sourcelibrary https://sourcelibrary.org/api/mcp
  3. Claude Code で /mcp と入力

    Source Library が一覧にあり、接続済みと表示されれば OK です

  4. 試してみる

    Source Library を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Source Library を使っていると言うか、回答に Source Library のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  2. Cursor の AI チャットを Agent モードで開く

  3. 試してみる

    Source Library を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Source Library を使っていると言うか、回答に Source Library のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  2. VS Code の AI チャットを Agent モードで開く

  3. 試してみる

    Source Library を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Source Library を使っていると言うか、回答に Source Library のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

Web 経由でつなぐアプリ用のアドレス

アドレスhttps://sourcelibrary.org/api/mcp

JSON 設定は下の「開発者向け」にあります

つまずいたら?Source Library を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

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

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

GitHubスターi
30 (リポジトリ全体のスター)
このリポジトリには複数の MCP があり、スターは順位で1件だけ数えます
週あたりのダウンロードi
npm/PyPIにない
接続方法
クラウドで動く
トランスポート
streamable-http
最新バージョンi
4.13.0
レジストリ公開日i
2026年11月6日
コードの最終更新i
2026年11月18日
最終確認
2026年11月16日
作者
Embassy-of-the-Free-Mind
ウェブサイト
sourcelibrary.org
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

インターネット経由でつなげるアプリ

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

すべてのアプリと長所・短所 →

できること

ツールの名前と説明は、サーバーが2026年11月16日に返したそのままの内容です。書いたのは作者で、私たちではありません。プレーンテキストとして表示しています。

  • 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 AIへの指示のように見えます

    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

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント Embassy-of-the-Free-Mind で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:昨日

  • ✓ 合格

    ライセンスがある

    AGPL-3.0を使用

  • ✓ 合格

    エンドポイントが応答する

    751ミリ秒で応答(HTTP 200)

  • – 対象外

    OAuthでサインイン

    サインイン不要

  • ✕ 不合格

    ツールの説明に隠れた指示がない

    1件のツールの説明に、AIへの指示のように見える文章が含まれています。インストールする前に、下の内容を読んでください

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

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

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

ゲーム・スポーツ・料理・学習のほかのサーバーとの比較i

  • このカテゴリのほかの1619件のうち0%よりスターが多い
  • このカテゴリのほかの1619件のうち67%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの1619件のうち64%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Source Libraryは安全ですか?

当てはまる基本チェック5項目のうち4項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

作者のクラウドで動きます。インストール不要でインターネット経由でつながりますが、送った内容は作者のサーバーを通ります。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は昨日、最新バージョン(4.13.0)がレジストリに届いたのは13 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。

代わりに使えるものは?

同じカテゴリには:Anime Garden, WilmAI, Lumify Sports Intelligence, Savecraft, GoodWatch

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

WilmAI

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

作者:aikarjal成長中↓ 1399/週★ 89 リポジトリ全体のスター10 日前更新

パソコンで動く✓ 提供元 · wilm.ai

Savecraft

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

作者:joshsymonds初期★ 137 か月前更新

クラウドで動くリポジトリはアーカイブ済み✓ 提供元 · savecraft.gg

GoodWatch

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

作者:alp82初期★ 50 リポジトリ全体のスター30 日前更新

クラウドで動く✓ 提供元 · goodwatch.app
似たものと比べる
これ
Source Library
Anime GardenWilmAILumify Sports IntelligenceSavecraftGoodWatch
動く場所クラウドで動き、インストール不要クラウドで動き、インストール不要パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要いいえいいえいいえはいいいえいいえ
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック4/54/43/34/43/44/4
ライセンスAGPL-3.0AGPL-3.0MITMITApache-2.0MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

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

冒頭だけを表示しています。続きはリポジトリで読めます