Epublys

Epublys MCP Server

用于操作 EPUB 和 PDF 电子书的远程 MCP 服务——合并、拆分、压缩、转换、编辑元数据、验证，以及生成 AI 封面。由 epublys.com 提供支持，运行于 Cloudflare Workers。

这是一个托管服务（Streamable HTTP）。无需安装任何内容——此仓库包含公开清单、配置示例和文档。

• 端点： https://epublys.com/mcp（Streamable HTTP）
• 身份验证： 免费套餐无需身份验证。可选的 Bearer API 密钥（可在 https://epublys.com/account 免费获取）会使用您账户的额度和 Pro 权益。
• 服务卡片： https://epublys.com/.well-known/mcp/server-card.json
• 完整的 Agent 文档： https://epublys.com/llms-full.txt
• 注册表： 官方 MCP 注册表中的 com.epublys/epublys

快速开始

无需密钥（免费套餐）

Claude Code：

claude mcp add --transport http epublys https://epublys.com/mcp

其他任何 MCP 客户端（claude_desktop_config.json、cline_mcp_settings.json 等）：

{
  "mcpServers": {
    "epublys": {
      "url": "https://epublys.com/mcp"
    }
  }
}

免费套餐通过 IP 地址识别用户，并与网站共享每日免费额度。该套餐长期有效，并非试用版。

使用密钥（您账户的额度、Pro）

1. 在 https://epublys.com/account 登录并创建 API 密钥（epl_…——仅显示一次）。
2. 将其作为 Bearer 标头发送：

{
  "mcpServers": {
    "epublys": {
      "url": "https://epublys.com/mcp",
      "headers": { "Authorization": "Bearer epl_YOUR_KEY_HERE" }
    }
  }
}

Claude Code：claude mcp add --transport http epublys https://epublys.com/mcp --header "Authorization: Bearer epl_YOUR_KEY_HERE"

错误、格式不正确或已撤销的密钥会返回 401，不会静默回退到免费套餐。密钥只能放在 Authorization 标头中；放在 URL 中的密钥会被拒绝。

工具

工具	描述
merge_epub	将多个 EPUB 文件合并为一个
split_epub	按章节范围拆分 EPUB
compress_epub	压缩 EPUB 以减小文件大小
epub_to_pdf	将 EPUB 转换为 PDF
pdf_to_epub	将 PDF 转换为 EPUB
epub_to_markdown	将 EPUB 转换为 Markdown
markdown_to_epub	根据 Markdown 文件构建 EPUB3（支持 YAML frontmatter、Obsidian 双向链接）
docx_to_epub	将 DOCX 转换为 EPUB
read_epub_metadata	读取 EPUB 元数据
edit_epub_metadata	编辑 EPUB 元数据和封面
validate_epub	验证 EPUB 结构（可选自动修复）
generate_cover	根据描述生成 AI 书籍封面（Pro）
upgrade_to_pro	为密钥所属账户返回 Stripe 结账链接（不带密钥的调用会获取定价 URL）

文件以 Base64 编码字符串的形式传入工具参数并在结果中返回。

限制

	免费	Pro（$9/月或 $72/年）
文件大小	5 MB（split_epub 为 15 MB，pdf_to_epub 为 10 MB）	每次请求 30 MB
合并	最多 10 个文件，总计 20 MB	最多 50 个文件，总计 30 MB
每日操作次数	每天 3 次（读取元数据从不计入额度）	不限
速率	15 次请求/分钟	60 次请求/分钟
输出品牌标识	Epublys 版权页	无
generate_cover	—	每月 30 次

隐私

文件在内存中处理，绝不存储。没有上传存储桶、没有保留期限，也不会记录内容。仅收集匿名使用指标（工具名称、状态、大小）。

REST API

同样的工具也可通过纯 REST 接口使用，并提供 OpenAPI 规范——请参阅 https://epublys.com/for-ai-agents。

关于此仓库

Epublys 服务本身是闭源的。此仓库仅包含公开的 MCP 清单（server.json、smithery.yaml）和文档，也是 com.epublys/epublys 注册表条目的官方公开仓库。欢迎提交与 MCP 集成问题相关的 Issues；产品支持请访问 https://epublys.com/about。