Library of Alexandria

面向开发者的亚历山大图书馆

图书馆的目录、免费书架和印刷版，整合为一小组只读工具，任何程序、助手或模型都可以调用。无需密钥，也无需注册。这些工具绝不会让任何人登录、收取费用或更改任何内容；它们返回的每本书都附有其在 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> 和 GET .../v1/openapi.json	脚本、自动化工具（n8n、Zapier、Make、Dify、Flowise）、Open WebUI 工具服务器、Copilot Studio
面向模型开发者的工具文件	`GET .../v1/tools?format=openai	openai-chat

八个工具

工具	功能
search_books	根据书名、作者或主题中的词语查找书籍，支持目录中的所有语言
get_book	一本书的相关信息：作者、原书名、封面、印刷版，以及各语言版本的页面
get_summary	完整获取一本书 15 分钟摘要中的第一个关键观点，以及其余摘要的标题（用 part 选择其中一个）
get_sample	获取一本书的免费开篇，每页最多 400 个单词（用 page 选择页面）
list_free_shelf	按语言和主题列出免费书架上的书籍
read_free_chapter	阅读免费书架上一本书的一章，每页最多 400 个单词
get_print_options	查看一本书的印刷版（标准版和大字版；平装或精装）及其美元标价
get_publisher_info	了解图书馆的出版方、语言、条款和隐私页面

如果一本书的摘要、样页或免费书架章节尚未开放（书籍尚未上线、某种语言尚未开放，或所有文本都尚未上线），工具会直接回答“即将在此开放”；之后工具会自动补上内容，你无需做任何更改。文本工具会统计为每个客户端提供的单词数（每天 72,000 个，每小时 48,000 个），并在 budget 中显示剩余数量。

一分钟上手

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"}。出错时会返回 application/problem+json（RFC 9457），其中包含稳定的 code；详见 openapi/loa-api.openapi.json。

此文件夹的内容

路径	内容
openapi/loa-api.openapi.json	OpenAPI 3.1 文件（也通过 /v1/openapi.json 提供实时版本）
function-tools/*.json	采用 OpenAI（Responses 和 Chat Completions）、Anthropic、Gemini、Ollama 和 MCP 格式的八个工具
cli/loa.mjs	命令行工具 loa（Node 18 或更高版本，无依赖项）
sdk/typescript/loa.mjs, loa.d.ts	JavaScript 和 TypeScript 客户端（无依赖项；支持浏览器、Node、Deno、Bun、Workers）
sdk/python/loa_library.py	Python 客户端（仅使用标准库）
sdk/python/loa_tools.py	每个工具对应一个纯 Python 函数，供 Ollama 及任何根据类型提示构建工具 schema 的框架使用
mcp-bridge/loa-mcp.mjs	面向无法连接远程服务的 MCP 客户端的 stdio 桥接程序
quickstarts/	LM Studio、Open WebUI、Ollama、Goose、Claude、ChatGPT、Cursor、VS Code、LangChain 和 OpenAI Agents SDK 的连接指南
AGENTS.md, SKILL.md	面向编码 Agent 的说明，以及面向协助读者使用图书馆的助手的说明
tests/	此工具包的测试（node --test tests/*.test.mjs 和 python3 tests/test_python.py）

生成的文件（openapi/、function-tools/）由服务自身的代码生成；如果这些文件不是最新版本，服务中的测试就会失败。

适用于所有引用本书库的人士的规则

• 如实转述答案；使用标题给出的 url；切勿编造价格或优惠。
• 本书库不是古代的亚历山大图书馆，也不是亚历山大图书馆（Bibliotheca Alexandrina）。
• 付款和注册只能在 libraryofalexandria.com 上进行；工具可以提供链接，但绝不能收款。
• 请将请求频率控制在每秒几次，并发送一个能标明你程序名称的 User-Agent。

版本

API 版本是一个日期，会通过 LOA-Version 标头返回（2026-10-25）。更改会在开发者页面上公布。

许可证

MIT，参见 LICENSE。本书库的工具会根据服务允许的范围返回目录事实、简短摘要和免费内容；此许可证涵盖这些代码和文档，不涵盖书籍。

注册表条目

官方 MCP Registry 中的服务描述位于 server.json。