Source Library

Pesquise e cite mais de 500 textos históricos traduzidos (alquimia, hermetismo, Renascença) com citações acadêmicas apoiadas por DOI. Acesse manuscritos raros em latim e alemão dos séculos XV ao XVIII.

Documentação

Servidor MCP da Source Library

npm version

Pesquise, leia e cite mais de 22.000 textos pré-modernos raros (alquimia, Hermetica, Cabala, teologia, ciência primitiva) com traduções para o inglês geradas por IA. 12 ferramentas (busca de texto completo e semântica, leitura, citações exatas, busca de imagens, detecção de duplicatas, feedback, compartilhamento de descobertas). CLI + servidor MCP, sem necessidade de chave de API.

Início Rápido

Claude Code

claude mcp add source-library -- npx -y @source-library/mcp-server

Claude Desktop

Adicione à sua configuração do Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "source-library": {
      "command": "npx",
      "args": ["-y", "@source-library/mcp-server"]
    }
  }
}

CLI

# Install globally
npm install -g @source-library/mcp-server

# Or run directly
npx @source-library/mcp-server search "philosopher's stone"

A partir do código-fonte

git clone https://github.com/Embassy-of-the-Free-Mind/sourcelibrary-v2.git
cd sourcelibrary-v2/mcp-server
npm install && npm run build
npm start

12 Ferramentas

Pesquisa e Descoberta

search_library

Busca de texto completo em livros e conteúdo de páginas. Retorna livros e páginas correspondentes com URLs de citação.

ParâmetroTipoObrigatórioDescrição
querystringSimConsulta de pesquisa
languagestringNãoFiltro: latim, alemão, grego, sânscrito, etc.
year_fromnumberNãoAno de publicação inicial
year_tonumberNãoAno de publicação final
has_doibooleanNãoApenas livros com DOI
has_translationbooleanNãoApenas livros traduzidos
sortstringNãorelevância, data_asc, data_desc, título
limitnumberNãoMáximo de resultados (padrão 10, máximo 100)

search_translations

Pesquise dentro do texto traduzido em toda a biblioteca. Encontre o que autores históricos escreveram sobre qualquer tópico. Retorna trechos de passagens com números de página, informações do livro e URLs de citação.

ParâmetroTipoObrigatórioDescrição
querystringSimPesquisar dentro do texto da página
languagestringNãoFiltrar pelo idioma original do livro
year_fromnumberNãoAno de publicação inicial
year_tonumberNãoAno de publicação final
book_idstringNãoPesquisar apenas em um livro específico
limitnumberNãoMáximo de resultados (padrão 20, máximo 50)

search_concept

Busca semântica de passagens usando embeddings do Gemini. Encontra passagens conceitualmente relacionadas mesmo quando o termo moderno não aparece literalmente — por exemplo, "cognição distribuída" mapeia para passagens sobre intelecto ativo, arte da memória, metáforas de tabletes de cera. Prefira search_translations para frases literais; use search_concept quando o conceito importa mais que a redação.

ParâmetroTipoObrigatórioDescrição
querystringSimConceito ou descrição em linguagem natural
languagestringNãoFiltrar por idioma original (defina explicitamente para exibir textos não latinos/alemães)
year_fromnumberNãoAno de publicação inicial
year_tonumberNãoAno de publicação final
limitnumberNãoMáximo de passagens (padrão 15, máximo 50)

search_within_book

Pesquise dentro das páginas de um livro específico. Retorna páginas correspondentes com trechos e URLs de citação.

ParâmetroTipoObrigatórioDescrição
book_idstringSimO ID do livro para pesquisar
querystringSimConsulta de pesquisa

list_books

Navegue pela coleção com filtros. Retorna título, autor, idioma, ano e progresso da tradução.

ParâmetroTipoObrigatórioDescrição
searchstringNãoFiltrar por título/autor (insensível a diacríticos)
languagestringNãoFiltrar por idioma
categorystringNãoFiltrar por categoria
sortstringNãotradução-recente, recente, título-asc, título-desc
limitnumberNãoMáximo de resultados (padrão 100, máximo 200)

Leitura

get_book

Metadados detalhados do livro: resumo, estatísticas do índice, capítulos, informações da edição, DOI.

ParâmetroTipoObrigatórioDescrição
book_idstringSimID do livro

get_book_text

Leia um livro. Prefira chapter para leitura capítulo por capítulo; recorre a intervalos de páginas from/to. Cada resposta inclui um sinalizador truncated com um truncation_note fornecendo os próximos valores de from/to quando o conteúdo foi cortado pelo limite de orçamento de páginas — os agentes devem verificar truncated em vez de inferir o fim do livro a partir de pages_returned.

ParâmetroTipoObrigatórioDescrição
book_idstringSimID do livro
chapternumberNãoÍndice do capítulo (baseado em 0); preferido em vez de de/até
partnumberNãoNúmero da parte (baseado em 1) para capítulos divididos entre partes
contentstringNãoocr, tradução ou ambos (padrão)
fromnumberNãoPágina inicial (inclusiva)
tonumberNãoPágina final (inclusiva)
formatstringNãojson (estruturado) ou texto simples (texto concatenado)
include_metadatabooleanNãoIncluir metadados no nível da página (modelo, idioma, etc.)

get_quote

Obtenha o texto traduzido exato de uma única página para citação. Retorna a tradução literal, o OCR original e uma citação formatada. O título da resposta é citation_link — o link curto estável sourcelibrary.org/q/… para apresentar junto com a citação e seu número de página. Use sempre isto antes de colocar texto entre aspas — nunca parafraseie de memória. Renderização sugerida: > [quote] e depois — [Author], p. [N]. [citation_link].

ParâmetroTipoObrigatórioDescrição
book_idstringSimID do livro ou slug
pagenumberSimNúmero da página para citar

Galeria

search_images

Pesquise na coleção visual: mais de 50.000 ilustrações extraídas de páginas de livros MAIS mais de 23.000 obras de arte independentes (pinturas, afrescos, gravuras, esculturas do Met, Rijksmuseum, Wikimedia, NGA). Cada resultado tem um campo source: gallery (ilustração de livro) ou artwork (obra independente).

ParâmetroTipoObrigatórioDescrição
querystringNãoBusca de texto em descrições, assuntos, figuras, artistas
sourcestringNãotodos (padrão), galeria ou obras
typestringNãoxilogravura, gravura, emblema, diagrama, pintura, afresco, etc.
subjectstringNãoAssunto (alquimia, astronomia, anatomia)
figurestringNãoFigura representada (Mercúrio, filósofo, rei)
symbolstringNãoSímbolo (ouroboros, caduceu, sol)
year_fromnumberNãoAno de publicação inicial
year_tonumberNãoAno de publicação final
book_idstringNãoApenas imagens de um livro específico ou ID de obra
min_qualitynumberNãoPontuação mínima de qualidade da galeria 0-1 (padrão 0,5)
limitnumberNãoMáximo de resultados (padrão 20, máximo 50)

Curadoria

check_duplicate

Verifique se um livro já existe na Source Library antes de importar. Usa correspondência em 4 níveis (impressão digital da fonte, normalização de título+autor, busca por palavras-chave, similaridade semântica) e retorna um nível de confiança + sugestão. Use isto antes de cada importação para evitar duplicatas.

ParâmetroTipoObrigatórioDescrição
titlestringSimTítulo do livro (original ou em inglês)
authorstringNãoNome do autor (qualquer formato)
yearstringNãoAno de publicação (contexto opcional)
languagestringNãoIndicação de idioma para busca semântica
ia_idstringNãoIdentificador do Internet Archive (correspondência exata de impressão digital)
manifeststringNãoURL do manifesto IIIF (correspondência exata de impressão digital)

Feedback

submit_feedback

Envie feedback, relatórios de bugs ou solicitações de recursos diretamente para a equipe da Source Library.

ParâmetroTipoObrigatórioDescrição
messagestringSimSeu feedback (2-5000 caracteres)
namestringNãoSeu nome
emailstringNãoE-mail para acompanhamento
pagestringNãoURL da página relacionada

share_findings

Compartilhe um dossiê de pesquisa de volta com a equipe da Source Library — um título, resumo opcional e uma lista ordenada de citações ({ book_id, page, note }, referências, não texto copiado). Como submit_feedback, vai para a equipe para revisão.

ParâmetroTipoObrigatórioDescrição
titlestringSimTítulo do dossiê / tese (2-300 caracteres)
summarystringNãoProsa resumindo o argumento (máx. 5000 caracteres)
citationsarraySimPassagens { book_id, page, note } ordenadas (1-50)
namestringNãoSeu nome
emailstringNãoE-mail para acompanhamento

CLI

A maioria das ferramentas também está disponível como CLI independente com saída de terminal colorida. (search_concept e check_duplicate são apenas MCP por enquanto.)

# Search the collection
source-library search "Paracelsus" --language=German

# Search inside translations
source-library translations "harmony of the spheres"

# Read a book
source-library text 694f49d3... --from=1 --to=50

# Book details
source-library book 694f49d3...

# Browse the gallery
source-library images --subject=alchemy --type=emblem

# Submit feedback
source-library feedback "Great translation of Fludd!" --name="Jane"

# JSON output for piping
source-library search "alchemy" --json | jq .results

Exemplos de Prompts de Pesquisa

"Pesquise referências a 'prima materia' em toda a coleção. Quais autores a discutem e como suas abordagens diferem?"

"Leia a tradução completa da História de Ambos os Mundos de Fludd, páginas 1-50. Resuma o arcabouço cosmológico."

"Encontre todos os emblemas alquímicos que representam o ouroboros. De quais textos eles vêm?"

"O que Copérnico diz sobre a centralidade do Sol em De Revolutionibus? Encontre as passagens-chave com URLs de citação."

URLs de Citação

Toda página retornada pelas ferramentas inclui uma URL de citação:

https://sourcelibrary.org/book/fludd-utriusque?page=57

Edições publicadas incluem DOIs cunhados via Zenodo.

Desenvolvimento

npm run dev    # Run with hot reload (tsx)
npm run build  # Compile TypeScript
npm start      # Run compiled version
npm run cli    # Run CLI in dev mode

Licença

MIT

Links