개발자 | 알렉산드리아 도서관

도서관의 도서 목록, 무료 책장, 인쇄 판본은 프로그램, 도우미, 모델이 이용할 수 있는 열아홉 개의 공개 읽기 전용 도구로 제공돼요. 키도 필요 없고 가입할 필요도 없어요. 본인의 계정을 도우미에 연결하면 일곱 개의 추가 도구로 개인 도서관을 읽을 수 있어요(내 도서관 참조). 도구는 누구도 로그인시키거나 결제를 받거나 무언가를 변경하지 않아요. 모든 도서는 libraryofalexandria.com의 해당 페이지 주소와 함께 반환되며, 그 페이지에서 읽기, 듣기, 인쇄 또는 시작을 할 수 있어요.

세 가지 접속 방법

MCP (Streamable HTTP) 주소 https://mcp.libraryofalexandria.com/mcp: Claude, ChatGPT, Gemini, Grok, Copilot, Perplexity, Le Chat, LM Studio, Open WebUI, Cursor, VS Code, Goose 및 그 밖의 모든 MCP 클라이언트에서 이용할 수 있어요.
REST 및 OpenAPI 3.1: POST https://api.libraryofalexandria.com/v1/<tool> 및 https://api.libraryofalexandria.com/v1/openapi.json의 OpenAPI 파일: 스크립트, 자동화 도구(n8n, Zapier, Make, Dify, Flowise), Open WebUI 도구 서버 및 Copilot Studio에서 이용할 수 있어요.
모델 개발자를 위한 도구 파일: GET https://api.libraryofalexandria.com/v1/tools?format=openai: 모델에 도구 정의를 전달하는 모든 프로그램에서 이용할 수 있어요. 형식은 openai, openai-chat, anthropic, gemini, ollama, mcp예요.

일 분 만에 사용해 보기

curl -s https://api.libraryofalexandria.com/v1/search_books \
  -H 'content-type: application/json' \
  -d '{"query":"moby dick","limit":3}'

응답은 {"ok": true, "data": {...}, "source": "Library of Alexandria, libraryofalexandria.com"}예요. data.results의 각 도서에는 id, title, author와 해당 페이지의 url이 있어요.

열아홉 개의 도구

여덟 개는 도서를 조회하고, 한 개는 인쇄 판본을 보여 주고, 네 개는 개인용 인쇄본을 준비하며, 여섯 개는 학습과 선택을 도와줘요. MCP 주소의 ?toolset=으로 도우미에 표시할 도구를 선택하세요. 소형 로컬 모델에는 짧은 목록이 적합해요.

https://api.libraryofalexandria.com/mcp: 로그인 없이 이용하는 열아홉 개의 공개 도구예요(디렉터리에 등록된 주소).
https://mcp.libraryofalexandria.com/mcp?toolset=catalogue,study,orders: 동일한 열아홉 개의 공개 도구예요.
?toolset=catalogue,orders: 도서를 조회하고, 인쇄 판본을 보여 주고, 개인용 인쇄본을 준비하는 열세 개의 도구예요.
?toolset=study: 여섯 개의 학습 도구예요.
https://mcp.libraryofalexandria.com/mcp에 toolset을 지정하지 않으면 열아홉 개의 공개 도구와 개인 도서관용 도구 일곱 개, 모두 스물여섯 개를 이용할 수 있어요. 일곱 개의 도구는 본인이 허용한 경우에만 응답해요.

search_books (query, language, limit): 도서 목록에 있는 모든 언어로 제목, 작가 또는 주제에 포함된 단어를 통해 도서를 찾아요.
get_book (id, language): 도서 한 권의 작가, 원제, 표지, 인쇄 판본 및 각 언어별 페이지 정보를 제공해요.
get_summary (id, language, part): 도서 한 권의 15분 요약에서 첫 번째 핵심 내용의 전문과 나머지 핵심 내용의 제목을 제공해요.
get_sample (id, language, page): 도서 한 권의 도입부를 페이지당 최대 400단어로 무료 제공해요.
list_free_shelf (language, subject, limit): 무료 책장의 도서를 언어와 주제별로 제공해요.
read_free_chapter (id, chapter, page, language): 무료 책장에 있는 도서의 한 장을 페이지당 최대 400단어로 제공해요.
get_print_options (id, language): 도서 한 권의 인쇄 판본(일반 글자 크기의 책과 큰글자책, 페이퍼백 또는 하드커버)과 각 판본의 미국 달러 가격을 제공해요.
quote_custom_print (id, language, edition, quantity, dedication, gift, cover, country): 개인 메시지 페이지가 포함된 한 작품의 종이책 가격, 주문 수량에 따른 총액, 메시지를 작성하고 주문하는 페이지예요.
get_cover_upload_link (id, language): 종이책에 직접 준비한 표지 이미지를 추가하는 페이지예요.
create_custom_print_order (quote_id): 메시지를 작성하고 인쇄 시안을 확인한 뒤 결제하는 페이지예요. 도우미를 통해서는 주문이나 결제가 이루어지지 않아요.
get_order_status (order_ref, email, language): 종이책 주문의 진행 상태예요.
get_publisher_info: 도서관의 발행 주체, 지원 언어, 이용약관과 개인정보 처리방침 페이지예요.
browse_collection (collection, language, limit, cursor): 미리 구성된 책장에서 한 번에 여덟 작품씩 보여줘요. 무료 도서, 쉬운 수준·중간 수준·어려운 수준의 도서, 잊힌 도서, 요약이 있는 작품, 가장 인기 있는 작품을 볼 수 있어요.
get_book_facts (id, language): 한 작품의 독서 정보예요. 난이도, 분량, 세 가지 읽기 속도에 따른 독서 시간, 페이지 수, 오디오 재생 시간, 초판 발행 연도를 알려줘요.
get_themes (id, language): 한 작품의 학습 가이드예요. 주제, 상징, 배경, 모티프와 전체 가이드의 주소를 제공해요.
get_chapter_summary (id, language, chapter): 장, 막 또는 장면 하나의 요약이에요. 장을 지정하지 않으면 장 목록을 제공해요.
find_quote_source (quote, language): 여섯 단어 이상인 인용문의 출처인 공개 본문과 장, 문단을 찾아줘요. 위치만 알려주며 책의 문구는 반환하지 않아요.
explain_phrase (phrase, language): 격언이나 관용구의 뜻과 유래, 해당 표현이 쓰인 작품을 알려줘요.
recommend_classics (query, language, level, free_only, limit): 좋아했던 작품이나 주제, 분위기를 바탕으로 다음에 읽을 책을 추천해요.

아직 공개되지 않은 요약, 샘플 페이지 또는 무료 책장의 장을 요청하면 곧 이곳에서 공개된다고 명확히 안내해요. 특정 작품이나 언어가 아직 공개되지 않았거나 모든 본문이 온라인에 올라오기 전인 경우에도 같아요. 이후에는 별도로 변경할 필요 없이 내용이 채워져요. 책 전체를 반환하는 도구는 없어요. 도구는 짧고 제한된 분량만 반환하며, 클라이언트별로 제공한 단어 수를 집계해요(하루 72,000단어, 시간당 48,000단어이며, 응답에 남은 단어 수가 표시돼요).

도우미 연결하기

스물여섯 도구 모두 읽기만 하므로 어떤 클라이언트에서든 매번 확인하지 않고 허용할 수 있어요. 주소는 https://mcp.libraryofalexandria.com/mcp예요(공개 도구 열아홉 개만 사용하려면 ?toolset=catalogue,study,orders를 추가하거나 https://api.libraryofalexandria.com/mcp를 사용해요).

Claude: 설정, 커넥터, 사용자 지정 커넥터 추가를 선택해요. Claude Code에서는 claude mcp add --transport http library-of-alexandria https://mcp.libraryofalexandria.com/mcp를 사용해요.
ChatGPT: chatgpt.com/plugins를 열고 더하기 버튼과 사용자 지정 MCP 서버 추가를 선택한 뒤, 주소를 입력하고 플러그인을 만들어요.
Cursor: ~/.cursor/mcp.json의 mcpServers 아래에 "library-of-alexandria": {"url": "https://mcp.libraryofalexandria.com/mcp"}를 추가해요.
VS Code: 명령 팔레트에서 MCP: 서버 추가를 실행하고 HTTP를 선택한 뒤 주소를 입력해요.
LM Studio (0.3.17 이상): 프로그램 탭, 설치, mcp.json 편집을 선택한 뒤 mcpServers 아래에 같은 url 항목을 추가해요.
Open WebUI (0.6.31 이상): 설정, 관리자, 통합, 외부 도구 서버, 연결 추가를 선택해요. 유형은 MCP (Streamable HTTP)로 선택하고 주소를 입력한 뒤 인증 없음을 선택해요. 또는 OpenAPI 유형을 선택하고 OpenAPI 파일의 주소를 입력해요.
OpenAI Responses API: tools에 {"type": "mcp", "server_label": "library", "server_url": "https://mcp.libraryofalexandria.com/mcp", "allowed_tools": ["search_books", "get_book"], "require_approval": "never"}를 전달해요.

작은 로컬 모델은 도구 목록이 짧을 때 가장 잘 작동해요. 작업에 필요한 도구만 연결하세요.

내 도서관 (허락을 받아 사용하는 일곱 가지 도구)

libraryofalexandria.com에 계정이 있으면 개인 도우미가 내 도서관을 살펴보고 읽고 있는 책에 관해 대화하도록 허용할 수 있어요. 도우미는 한 번만 권한을 요청해요. 계정 소유자는 libraryofalexandria.com에서 승인하고, 연결된 도우미 페이지에서 언제든 연결을 해제할 수 있어요.

get_my_plan: 요금제, 요금제 상태, 오늘 남은 본문 단어 수예요.
list_my_library: 도서관에 있는 책을 상태별로 보여줘요 (읽고 싶음, 읽는 중, 다 읽음, 잠시 중단, 읽기 포기).
get_book_outline: 책의 장 목록과 각 장의 무료 여부, 열림 또는 잠김 상태를 보여줘요. 본문은 없어요.
get_listen_link: 책이나 장의 듣기 페이지 주소예요.
open_in_reader: 뷰어에서 특정 장과 문단을 여는 주소예요.
search_in_book: 한 책의 열린 장에서 키워드를 검색해요. 위치 정보가 포함된 짧은 발췌문을 제공해요.
get_passage: 위치 정보로 구절 하나를 가져와요. 최대 400단어이며, 인용 정보와 주소가 포함돼요.

본문이 열려 있는 책과 해당 계정으로 읽을 수 있는 장에서만 한 번에 최대 400단어의 본문을 가져와요. 연결에는 PKCE를 적용한 OAuth 2.1을 사용해요. 문서는 /.well-known/oauth-protected-resource/mcp와 /.well-known/oauth-authorization-server에 있어요. 토큰 없이 호출하면 이 위치를 가리키는 WWW-Authenticate 헤더와 함께 401을 반환해요. 도우미는 Client ID Metadata Document 또는 POST /oauth/register로 등록해요 (한 주소에서 시간당 새 클라이언트 다섯 개).

REST API 호출하기

각 도구는 POST /v1/<tool> 작업 하나에 해당해요. 도구의 인수를 JSON 객체로 전달하며 키는 필요 없어요.

// JavaScript (Node 18 or newer, browsers, Deno, Bun, Workers)
const res = await fetch("https://api.libraryofalexandria.com/v1/get_book", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({ id: "top3500-00002", language: "en" }),
});
const { ok, data } = await res.json();
console.log(data.title, data.url);

# Python, standard library only
import json, urllib.request

req = urllib.request.Request(
    "https://api.libraryofalexandria.com/v1/list_free_shelf",
    data=json.dumps({"language": "es", "limit": 5}).encode(),
    headers={"content-type": "application/json"},
)
print(json.load(urllib.request.urlopen(req))["data"]["titles"])

OpenAPI 파일과 도구 파일

/v1/openapi.json의 OpenAPI 3.1 파일에는 모든 작업과 인수, 응답 구조가 설명되어 있어요. Open WebUI, Dify, Flowise, Copilot Studio 또는 OpenAPI 도구로 가져오세요. 도구 정의를 모델에 전달하는 프로그램에서는 GET /v1/tools?format=가 각 제공업체에서 요구하는 형식으로 도구를 반환해요 (공개 도구 열아홉 개만 받으려면 &toolset=catalogue,study,orders를 추가하세요). 지원 형식은 openai (Responses API), openai-chat (Chat Completions), anthropic, gemini, ollama, mcp (MCP 서버가 보여주는 목록)예요. 모델의 호출에는 위의 REST 작업으로 응답하세요.

오류

문제가 발생하면 application/problem+json (RFC 9457) 형식으로 반환되며, type, title, status, detail과 일정하게 유지되는 code가 포함됩니다.

400 invalid_json, invalid_request, unknown_format: 요청 본문이 JSON이 아니거나, 인수가 누락되었거나 잘못되었거나 (어떤 인수인지는 상세 정보에 표시됩니다), 알 수 없는 도구 파일 형식입니다.
404 unknown_tool, not_found: 해당 도구 또는 도서가 없습니다.
405 method_not_allowed: 도구는 POST를, 문서는 GET을 사용합니다.
413 payload_too_large: 본문이 8 KB를 초과합니다.
415 unsupported_media_type: 본문은 JSON 형식이어야 합니다.
500 internal: 지금은 도서관에서 응답할 수 없습니다. 잠시 후 다시 시도해 주십시오.

응답 사용하기

응답 내용을 그대로 전달하고 도서의 url을 제공된 대로 사용하십시오. 가격이나 혜택을 지어내지 마십시오.
이 도서관은 고대 알렉산드리아 도서관이나 비블리오테카 알렉산드리나가 아닙니다.
결제와 가입은 libraryofalexandria.com에서만 이루어집니다. 도구는 링크를 전달할 수 있지만 결제를 받지는 않습니다.
키는 필요하지 않습니다. 요청은 초당 몇 회 이내로 유지하고 프로그램 이름이 명시된 User-Agent를 보내 주십시오.

개발자 약관

공개 도구는 이 페이지에 명시된 한도 내에서 키 없이 무료로 사용할 수 있습니다. libraryofalexandria.com에 로그인한 사람이 만든 개발자 키를 사용하면 한도가 늘어나고 사용량을 확인할 수 있습니다. 무료 요금제의 한도는 키 개수와 관계없이 계정당 분당 60회, 매월 1,000회 호출입니다.
응답은 사람들이 책을 찾고 읽고 주문하는 데 도움을 주는 용도로 사용하십시오. 응답 내용을 그대로 전달하고 당사 페이지 링크를 유지하며, 당사의 요약, 학습 가이드 또는 본문을 직접 작성한 것처럼 제시하지 마십시오.
당사의 본문, 요약 또는 학습 가이드를 대량으로 복사하거나, 응답용 저장소로 보관하거나, 재판매하거나, 모델 학습에 사용하지 마십시오. 이러한 사용에는 서면 라이선스가 필요합니다. 인공지능 및 데이터 라이선스를 참조하십시오.
한도를 우회하거나 키를 공유하거나 다른 사람의 도구 사용 속도를 저하하는 방식으로 호출하지 마십시오. 당사는 이러한 행위를 하는 키나 주소의 접근 속도를 낮추거나 접근을 제한 또는 종료할 수 있으며, 키 소유자는 언제든 키를 폐기할 수 있습니다.
도구는 있는 그대로 제공됩니다. 당사는 도구의 작동을 유지하며 도구를 변경하거나 종료할 수 있습니다. 변경 사항은 이 페이지에 공지합니다.

개인정보 보호

서비스는 도구 이름, 상태, 클라이언트 이름 및 버전별로 호출 횟수를 집계합니다. 요청 내용은 보관하지 않으며 쿠키를 설정하지 않습니다. 개인정보 처리방침과 서비스 이용약관이 적용됩니다.

버전

API 버전은 날짜로 표시되며 LOA-Version 헤더로 반환됩니다(현재 2026-10-25). 변경 사항은 이 페이지에 공지합니다.