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
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âmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
query | string | Sim | Consulta de pesquisa |
language | string | Não | Filtro: latim, alemão, grego, sânscrito, etc. |
year_from | number | Não | Ano de publicação inicial |
year_to | number | Não | Ano de publicação final |
has_doi | boolean | Não | Apenas livros com DOI |
has_translation | boolean | Não | Apenas livros traduzidos |
sort | string | Não | relevância, data_asc, data_desc, título |
limit | number | Não | Má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âmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
query | string | Sim | Pesquisar dentro do texto da página |
language | string | Não | Filtrar pelo idioma original do livro |
year_from | number | Não | Ano de publicação inicial |
year_to | number | Não | Ano de publicação final |
book_id | string | Não | Pesquisar apenas em um livro específico |
limit | number | Não | Má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âmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
query | string | Sim | Conceito ou descrição em linguagem natural |
language | string | Não | Filtrar por idioma original (defina explicitamente para exibir textos não latinos/alemães) |
year_from | number | Não | Ano de publicação inicial |
year_to | number | Não | Ano de publicação final |
limit | number | Não | Má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âmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
book_id | string | Sim | O ID do livro para pesquisar |
query | string | Sim | Consulta de pesquisa |
list_books
Navegue pela coleção com filtros. Retorna título, autor, idioma, ano e progresso da tradução.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
search | string | Não | Filtrar por título/autor (insensível a diacríticos) |
language | string | Não | Filtrar por idioma |
category | string | Não | Filtrar por categoria |
sort | string | Não | tradução-recente, recente, título-asc, título-desc |
limit | number | Não | Má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âmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
book_id | string | Sim | ID 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âmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
book_id | string | Sim | ID do livro |
chapter | number | Não | Índice do capítulo (baseado em 0); preferido em vez de de/até |
part | number | Não | Número da parte (baseado em 1) para capítulos divididos entre partes |
content | string | Não | ocr, tradução ou ambos (padrão) |
from | number | Não | Página inicial (inclusiva) |
to | number | Não | Página final (inclusiva) |
format | string | Não | json (estruturado) ou texto simples (texto concatenado) |
include_metadata | boolean | Não | Incluir 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âmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
book_id | string | Sim | ID do livro ou slug |
page | number | Sim | Nú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âmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
query | string | Não | Busca de texto em descrições, assuntos, figuras, artistas |
source | string | Não | todos (padrão), galeria ou obras |
type | string | Não | xilogravura, gravura, emblema, diagrama, pintura, afresco, etc. |
subject | string | Não | Assunto (alquimia, astronomia, anatomia) |
figure | string | Não | Figura representada (Mercúrio, filósofo, rei) |
symbol | string | Não | Símbolo (ouroboros, caduceu, sol) |
year_from | number | Não | Ano de publicação inicial |
year_to | number | Não | Ano de publicação final |
book_id | string | Não | Apenas imagens de um livro específico ou ID de obra |
min_quality | number | Não | Pontuação mínima de qualidade da galeria 0-1 (padrão 0,5) |
limit | number | Não | Má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âmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
title | string | Sim | Título do livro (original ou em inglês) |
author | string | Não | Nome do autor (qualquer formato) |
year | string | Não | Ano de publicação (contexto opcional) |
language | string | Não | Indicação de idioma para busca semântica |
ia_id | string | Não | Identificador do Internet Archive (correspondência exata de impressão digital) |
manifest | string | Não | URL 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âmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
message | string | Sim | Seu feedback (2-5000 caracteres) |
name | string | Não | Seu nome |
email | string | Não | E-mail para acompanhamento |
page | string | Não | URL 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âmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
title | string | Sim | Título do dossiê / tese (2-300 caracteres) |
summary | string | Não | Prosa resumindo o argumento (máx. 5000 caracteres) |
citations | array | Sim | Passagens { book_id, page, note } ordenadas (1-50) |
name | string | Não | Seu nome |
email | string | Não | E-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
- Site: sourcelibrary.org
- Desenvolvedores: sourcelibrary.org/developers
- GitHub: Embassy-of-the-Free-Mind/sourcelibrary-v2