ForgeMesh Library MCP

ForgeMesh Library — 面向 AI Agent 的公有领域知识库

ForgeMesh Labs 产品。

面向 Agent 的付费公有领域知识库。 提供全文搜索、图书元数据、章节、名篇引文、旗舰功能“向本书提问”检索，以及覆盖不断扩大的公有领域图书语料库的 100 多个精选主题书架——无需许可证、API 密钥或账户。通过 x402 使用 Base 上的 USDC 按次付费。

仅提供检索：每个答案都是从索引文本中提取的真实引文，并附有出处。这里没有任何内容是由大模型生成或总结的——因此可安全引用，适用于辅导 Agent、阅读应用、测验／课程生成器，以及任何“虚构引文比没有引文更糟糕”的工作流。

快速开始（Claude Desktop / Claude Code / 任意 MCP 客户端）

{
  "mcpServers": {
    "library": {
      "command": "npx",
      "args": ["-y", "@forgemeshlabs/library-mcp"],
      "env": {
        "WALLET_PRIVATE_KEY": "0x..."
      }
    }
  }
}

WALLET_PRIVATE_KEY 是一个用于 x402 微支付的 专用低余额 Base 钱包，切勿使用你的主钱包。1 美元的 USDC 可购买数十到数百次调用，具体取决于路由。

要求

Node.js 20+，以及一个已存入 USDC 的专用低余额 Base 钱包。服务不会为 Library 钱包以外的收款方、Base 主网以外的网络、USDC 以外的资产，或超过限额（每次调用 $0.02、每个会话 $10）的金额签名。环境变量 X402_MAX_PRICE_USD 和 X402_SESSION_BUDGET_USD 只能调低这些限额。请求仅限同源，超时时间为 60 秒，大小上限为 2 MB，且绝不跟随重定向。

工具

工具	费用	功能
search_literature	$0.02	在整个语料库中进行全文搜索——任何书籍中的真实引文
search_books	$0.005	按标题或作者子串搜索语料库
get_book_metadata	$0.002	获取某个 book_id 对应的标题、作者、年份、主题、书架和章节范围
get_chapter	$0.005	按 book_id 和章节编号获取一章的全文
get_quotes	$0.005	获取一本书中的名篇引文，可指定主题
ask_book	$0.01	向旗舰书籍（《白鲸》、《理想国》、《福尔摩斯探案集》……）提问，并获取附有出处的引文
browse_shelf	$0.003	浏览精选类别或主题书架（哥特式恐怖、俄罗斯文学、侦探小说等，共 100 多个书架）
book_of_the_day	$0.001	按日期设定种子的每日确定性选书

价格由在线服务设定，可能会变更——实际费用始终以调用时 x402 的 402 挑战为准，而非此表所列价格。

适用对象

专为适用于教育场景的 Agent 用例打造：

• 需要真实引文而非改写内容的辅导 Agent
• 阅读应用和读书会机器人
• 引用公有领域原文的测验和课程生成器
• 任何需要大型、低成本、无需许可证的文本语料库，且不想受免费 API 速率限制的 Agent

这里的任何内容都无需账户、API 密钥或许可证协商——整个语料库均属于公有领域，部分内容取自 Project Gutenberg 收藏。与 Project Gutenberg 无关联，也未获其认可。

语料库规模

语料库仍在不断扩充——最初有数百本书，目前正从 17,000+ 本朝约 62,000 本迈进，随着更多公有领域文本被编入索引，规模还会继续增长。不要在下游代码中硬编码图书数量；请调用 search_books 或 search_literature，以在线索引的结果为准。

旗舰书目（ask_book）

爱丽丝梦游仙境、孙子兵法、基督山伯爵、罪与罚、堂吉诃德、德古拉、科学怪人、远大前程、格林童话、简·爱、《沉思录》（马可·奥勒留）、白鲸、道林·格雷的画像、傲慢与偏见、福尔摩斯探案集、《伊利亚特》、《奥德赛》、《理想国》、时间机器、汤姆·索亚历险记、金银岛、瓦尔登湖、战争与和平、呼啸山庄。

其他书籍：改用 search_literature，或使用 search_books + get_chapter/get_quotes。ask_book 旗舰路由经过人工策划，其余语料可通过搜索访问。

书架（browse_shelf）

10 个精选分类（冒险、儿童经典、经典文学、经济与政治、哥特式恐怖、历史、哲学、诗歌、科学与自然、莎士比亚与戏剧），以及 100 多个根据古腾堡计划真实主题／书架元数据自动生成的主题书架（哥特小说、俄罗斯文学、侦探小说、禁书清单等）。

完整且最新的书架目录可免费浏览，无需付款或调用工具：

• https://library.forgemesh.io/llms.txt
• https://library.forgemesh.io/openapi.json

付款方式

无需注册、API 密钥或订阅。首次请求任何工具时，都会返回 HTTP 402 挑战；此 MCP 服务会签署 USDC 付款授权（EIP-3009）并自动重试。结果会包含在同一响应中；如果可用，链上结算详情会列在 _payment 下。

直接调用 API

更倾向于使用原始 HTTP？完整的 Agent 可读接口如下：

• https://library.forgemesh.io/llms.txt — 面向 Agent 的单页摘要
• https://library.forgemesh.io/openapi.json — OpenAPI 3.1，包含 x402 付款元数据、完整输入架构，以及每个路由的示例
• https://library.forgemesh.io/.well-known/x402.json — x402 发现清单

常见问题

内容由大模型生成吗？ 不会。所有响应都通过本地真实书籍全文索引检索生成。每条响应中的 method 字段都会明确说明这一点。

我需要账号或 API 密钥吗？ 不需要。x402 付款是唯一的凭证。

使用哪条链和哪种代币？ Base 主网（eip155:8453）上的 USDC。

我可以将其用于辅导或课程内容吗？ 可以，这正是预期用途。仅检索并引用原文段落的回答，比生成式摘要更适合教育场景。

---

由 ForgeMesh Labs 构建 · 由 x402 protocol 提供支持 · MIT 许可证