lyrenth-mcp

Lyrenth MCP 服务

通过任意 MCP 客户端读取 Lyrenth 的索引内容。

提供三个工具：

• read_url 将公开网页转换为整洁的 AIDocument：稳定的 Markdown，以及标题、描述和结构，同时去除导航和 模板内容。你的 Agent 可以读取经过清理、占用 token 更少的内容，而非 原始 HTML；每个结果都会显示相较原始页面节省了多少 token。
• read_urls 可通过一次批量调用对最多 20 个 URL 执行相同操作。
• check_usage 会报告你的套餐级别和额度使用情况。

读取请求通过 Lyrenth 的跨调用缓存解析；对于经过验证的域名， 返回的则是发布者的规范版本。

每个工具都会通过显式布尔值声明全部四种 MCP 工具注释（只读、 无破坏性、幂等，以及开放或封闭世界），HTTP 传输还附带 一套包含 14 项测试的测试套件，用于验证其安全状况。

托管服务，无需安装

如果你的 MCP 客户端支持带自定义标头的远程 HTTP 服务 （Claude 和 Cursor 的远程连接器支持），则无需运行任何程序：

• URL：https://api.lyrenth.com/mcp
• 标头：Authorization: Bearer aiwk_your_key_here

三个工具相同，密钥也相同。下方的 npx 方式适用于通过 stdio 进行 MCP 通信的客户端，以及偏好本地进程的用户。

设置

1. 在 https://lyrenth.com/signup 获取免费 API 密钥（每月可读取 2,000 次，无需信用卡）。
2. 将服务添加到你的 MCP 客户端。

Claude Desktop（一键安装）

从最新版本下载 lyrenth-mcp.mcpb 并打开。Claude Desktop 会安装服务并提示你输入 API 密钥；无需编辑配置文件。该安装包包含与 npm 包相同的代码。

自行构建：./scripts/build-mcpb.sh。

Claude Desktop / Cursor（手动配置）

添加到你的 MCP 配置中（Claude Desktop：claude_desktop_config.json）：

{
  "mcpServers": {
    "lyrenth": {
      "command": "npx",
      "args": ["-y", "lyrenth-mcp"],
      "env": { "LYRENTH_API_KEY": "aiwk_your_key_here" }
    }
  }
}

Claude Code

claude mcp add lyrenth -e LYRENTH_API_KEY=aiwk_your_key_here -- npx -y lyrenth-mcp

然后让你的助手读取一个页面，例如：“读取 https://example.com/article 并总结内容。” 它会调用 read_url 并返回 清理后的 AIDocument。

工具

工具	参数	返回内容
read_url	url（字符串，必填），fresh（布尔值，可选），max_tokens（整数，可选）	将页面作为整洁的 AIDocument 返回：简短的来源信息头（token 数量 + 相较原始 HTML 的缩减幅度）以及 Markdown 正文。fresh: true 会强制重新获取页面，而非使用缓存副本；max_tokens 会根据你的上下文预算限制正文长度，并在段落或句子的完整边界处截断。
read_urls	urls（包含 1-20 个字符串的数组，必填），fresh（布尔值，可选），max_tokens（整数，可选）	一次调用最多读取 20 个页面，每个页面都作为整洁的 AIDocument 返回，并针对每个 URL 单独处理错误（失败的 URL 会单独报告，不会影响其他 URL）。每个成功读取的 URL 计费 1 个额度。
check_usage	无	你的套餐级别、相对于每月限额的已用额度、剩余额度以及重置日期。

配置

环境变量	必填	默认值	说明
LYRENTH_API_KEY	是	无	在 https://lyrenth.com/signup 获取免费密钥
LYRENTH_API_URL	否	https://api.lyrenth.com	用于覆盖为预发布环境或自托管服务的地址

为什么要通过 Lyrenth 阅读

• 更简洁、更省成本。 每个 URL 都采用统一的 AIDocument 结构；与发送原始 HTML 给大模型相比，所需的 token 少得多。
• 多个调用方共享缓存。 多个 Agent 获取同一 URL 时，源站请求会减少到最低限度，因此速度更快，也更友好地访问源站。
• 验证后使用规范版本。 当网站所有者已通过 Lyrenth 完成验证时，你获取的就是他们编写的版本，并会根据他们的变更信号保持更新。

隐私

服务器只会向 Lyrenth 的 API（api.lyrenth.com）发送两项内容：你请求读取的 URL，以及用于验证身份并计量调用次数的 API 密钥。除此之外，没有任何内容会离开你的设备：不会发送你本地持有的页面内容、对话上下文或遥测数据。Lyrenth 如何处理获取的页面和账户数据，请参阅隐私政策： https://www.lyrenth.com/privacy。

许可证

MIT。请参阅 LICENSE。

本地构建

npm install
npm run build
LYRENTH_API_KEY=aiwk_... node dist/index.js   # speaks MCP over stdio

这是 Lyrenth 项目的一部分。AIDocument 格式是一项开放契约；请参阅 https://lyrenth.com/llms-full.txt。