LibGen MCP Server

此MCP（模型上下文协议）服务器允许您在LibGen（图书馆创世纪）上搜索书籍，并尝试直接下载到您的计算机下载文件夹中。

免责声明： 通过此工具与LibGen交互依赖于网络抓取，因为LibGen没有提供官方API。LibGen网站的结构可能会随时更改，这可能破坏该服务器的功能。请自行决定使用，并预期在图书搜索和下载过程中可能出现不一致或失败的情况。

预备条件

• Node.js（推荐版本16或更高）
• npm（随Node.js一起提供）

MCP配置

要使用此服务器与LLM或其他兼容MCP的客户端，需要使用以下配置进行注册。此设置将在临时环境中自动下载并运行服务器，无需手动全局安装：

{
  "mcpServers": {
    "libgen-book-finder": {
      "command": "sh",
      "args": [
        "-c",
        "cd $(mktemp -d) && npm install libgen-mcp-server && npx libgen-mcp-server-cli"
      ]
      // "env": {} // 如果将来服务器需要环境变量，请在此处添加
    }
  }
}

命令解释：

• sh -c "..."：执行提供的字符串作为shell命令。
• cd $(mktemp -d)：创建一个唯一的临时目录并将当前目录更改为该目录。这使安装隔离。
• npm install libgen-mcp-server：将您的包及其依赖项安装到这个临时目录中。
• npx libgen-mcp-server-cli：执行由安装您的包而提供的命令行界面（libgen-mcp-server-cli）。npx负责查找并运行二进制文件。

这确保了每次启动时（或根据npm install的缓存行为，在同一客户端会话中的后续运行），MCP客户端始终使用npm上可用的最新版本的libgen-mcp-server。

可用工具

searchAndDownloadBook

在LibGen上搜索指定的书籍，并尝试以首选格式（PDF或EPUB）将其下载到系统默认的下载文件夹中。

参数：

• query（字符串，必需）：用于搜索书籍的关键词。可以是书名、作者、ISBN或其他相关关键词。
  • 示例："The Hitchhiker's Guide to the Galaxy"
• format（字符串，可选）：首选书籍格式。接受'PDF'或'EPUB'（大小写不敏感）。如果未指定，默认为'PDF'。
  • 示例："epub"

示例用法（概念性，取决于您的LLM/客户端）： LLM，请使用libgen-book-finder找到《Sapiens by Yuval Noah Harari》并将其下载为EPUB格式。

这将转换为类似这样的MCP工具调用： searchAndDownloadBook({ query: "Sapiens by Yuval Noah Harari", format: "epub" })

工作原理（简述）

1. searchAndDownloadBook工具接收查询和首选格式。
2. 它构建了一个针对libgen.is（此镜像可能会改变）的搜索URL。
3. 它获取搜索结果页面并解析HTML以找到匹配的书籍及其详细页面链接。
4. 然后它获取书籍的详细页面并尝试找到直接下载链接。
5. 如果找到了下载链接，它将书籍内容流式传输到操作系统默认的下载文件夹中的文件。

重要说明：

• 可靠性： 找到并下载书籍的成功率很大程度上取决于LibGen网站及其HTML结构的当前状态。网站的变化可能会破坏此工具。
• 下载位置： 书籍保存在操作系统的标准下载文件夹中（例如，macOS/Linux上的~/Downloads，Windows上的C:\Users\YourUser\Downloads）。
• 错误处理： 基本的错误处理已经到位，但由于网络抓取的性质，无法完美预测或处理所有故障场景。如果出现问题，请检查服务器控制台日志以获取更多详情。
• 无浏览器模拟： 此工具使用直接HTTP请求（axios）和HTML解析（cheerio）。它不模拟完整的浏览器环境，因此可能无法绕过高级反机器人措施，如JavaScript挑战或复杂的CAPTCHA。