Pesquisa somente leitura de livros e autores na Open Library

Para quem

Para quem quer que um assistente pesquise informação de livros e autores na Open Library. O texto oficial descreve-o como um servidor MCP para a API Open Library, usado para search for book and author information. O título do repositório também diz que fala com a API Open Library do Internet Archive.

Não é um diretório de fundo local nem um sistema de empréstimo. Todas as ferramentas nomeadas são pesquisas somente leitura. Nenhum campo de API key aparece na configuração oficial.

Página oficial:

https://github.com/8enSmith/mcp-open-library

Primeira tentativa em 3 minutos

O texto oficial diz Nothing to install or build. Aponte o cliente para este pacote; a primeira execução é puxada pelo npx:

{
  "mcpServers": {
    "mcp-open-library": {
      "command": "npx",
      "args": ["-y", "mcp-open-library"]
    }
  }
}

Desde v1.0.3 é publicado no official MCP Registry como io.github.8enSmith/mcp-open-library; clientes que suportam o registry podem instalar por esse nome. Não procurar um instalador que não aparece.

Pré-requisitos: esta máquina consegue correr npx. Na primeira tentativa use um título ou um nome de autor que já conheça; não inventar ISBN nem Author Key. O texto oficial não exige um segredo.

Configuração: mcpServers.mcp-open-library. O texto oficial não nomeia um produto de cliente obrigatório nem um caminho de ficheiro de configuração.

A primeira chamada deve usar a ferramenta nomeada search_books. Pode pesquisar por qualquer combinação de query, title, author, subject, place, person, publisher e ISBN. Sucesso: volta uma página de resultados com num_found; o limit por omissão é 10, no máximo 50. Não chamar primeiro get_author_info, que precisa de um Author Key.

readOnlyHint não é risco zero. O texto oficial também escreve openWorldHint: os pedidos saem desta máquina e chegam à API Open Library. O cliente pode saltar uma confirmação «isto vai mudar coisas», mas a fronteira de rede e privacidade permanece.

Casos de uso

Caso 1: encontrar livros por condições combinadas. Chamar search_books. Os resultados são paginados: cada página tem no máximo limit itens (default 10, maximum 50), virar páginas com offset (maximum 1000) e devolve num_found. O texto oficial não descreve ordenação nem filtro de língua.

Caso 2: uma pesquisa mais estreita por título ou nome de autor. Chamar get_book_by_title, ou chamar get_authors_by_name. O texto oficial só diz pesquisar por title / name; não escreve regras de correspondência difusa. Se já tiver um Open Library Author Key, pode usar get_author_info para o detalhe; sem Key, não invente um.

Limites de uso

Limite de capacidade: as ferramentas nomeadas nas notas consecutivas são search_books, get_book_by_title, get_authors_by_name, get_author_info. Não completar ferramentas de capa ou de ir buscar por ID que não aparecem.

Limite de paginação: limit por omissão 10, máximo 50; offset máximo 1000. Não assumir paginação além dos números oficiais.

Limite de instalação: puxar com npx, ou o nome de registry io.github.8enSmith/mcp-open-library. O texto oficial não descreve cache offline.