Epublys

com.epublys由 epublys.com 发布官方发布者v1.0.1更新于 Oct 24, 2026

EPUB/PDF tools: merge, split, compress, convert, edit metadata, validate ebooks.

已验证Streamable HTTP可网页运行文件与存储媒体与设计

概览

AI 生成的概览

托管式 EPUB/PDF 电子书工具，让助手合并、拆分、压缩、转换、校验电子书并编辑元数据。

可以做什么
  • 合并、按章节范围拆分和压缩 EPUB 文件，可剥离未使用的图片与字体
  • 在 EPUB、PDF、Markdown 与 DOCX 之间转换，并可由 Markdown 章节构建 EPUB3
  • 读取与编辑 EPUB 元数据及封面图片
  • 校验 EPUB 结构，并可选自动修复常见问题
  • 按描述生成 AI 书籍封面（Pro），并返回升级用的 Stripe 结账链接
适用场景
适合希望助手在不安装本地工具的情况下整理、重构或转换电子书文件的场景，例如合并系列作品、拆出指定章节、把 Markdown 或 Word 稿件转成 EPUB，或检查 EPUB 是否符合规范。
运行要求
远程 Streamable HTTP 端点，无需安装。免费层无需账号，按 IP 地址识别。可选在 Authorization 请求头中提供 Bearer API 密钥（在 Epublys 账号中创建），以使用账号额度与 Pro 功能。文件以 base64 字符串传递，大文件会产生较大负载。
安装前请注意
免费层每天仅 3 次操作、每分钟 15 次请求，文件大小受限，输出带 Epublys 品牌标识；Pro 为每月 9 美元或每年 72 美元，upgrade_to_pro 会返回 Stripe 结账链接用于付款。文件会发送给第三方服务处理，其声明仅在内存中处理且不存储。编辑元数据和转换会返回修改后的文件，请保留原件。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Epublys，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/com.epublys%2Fepublys/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

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

README

Epublys MCP Server

Remote MCP server for EPUB and PDF ebook manipulation — merge, split, compress, convert, edit metadata, validate, and generate AI covers. Backed by epublys.com, running on Cloudflare Workers.

This is a hosted server (Streamable HTTP). There is nothing to install — this repository holds the public manifests, configuration examples, and documentation.

Quickstart

Without a key (free tier)

Claude Code:

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

Any other MCP client (claude_desktop_config.json, cline_mcp_settings.json, etc.):

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

The free tier is identified by IP address and shares the website's free daily allowance. It is permanent, not a trial.

With a key (your account's allowance, Pro)

  1. Sign in at https://epublys.com/account and create an API key (epl_… — shown once).
  2. Send it as a Bearer header:
json
{  "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"

A wrong, malformed or revoked key is a 401, not a silent fall back to the free tier. The key goes in the Authorization header only; a key in the URL is rejected.

Tools

ToolDescription
merge_epubMerge multiple EPUB files into one
split_epubSplit an EPUB by chapter ranges
compress_epubCompress an EPUB to reduce file size
epub_to_pdfConvert EPUB to PDF
pdf_to_epubConvert PDF to EPUB
epub_to_markdownConvert EPUB to Markdown
markdown_to_epubBuild an EPUB3 from Markdown files (YAML frontmatter, Obsidian wikilinks)
docx_to_epubConvert DOCX to EPUB
read_epub_metadataRead EPUB metadata
edit_epub_metadataEdit EPUB metadata and cover
validate_epubValidate EPUB structure (with optional auto-fix)
generate_coverGenerate an AI book cover from a description (Pro)
upgrade_to_proReturn a Stripe checkout link for the account behind the key (keyless calls get the pricing URL)

Files are passed as base64-encoded strings in tool arguments and results.

Limits

FreePro ($9/mo or $72/yr)
File size5 MB (15 MB split_epub, 10 MB pdf_to_epub)30 MB per request
Merge10 files, 20 MB total50 files, 30 MB total
Daily operations3 per day (reading metadata is never metered)unlimited
Rate15 req/min60 req/min
Output brandingEpublys colophonnone
generate_cover—30/month

Privacy

Files are processed in memory and never stored. There is no upload bucket, no retention, no content logging. Anonymous usage metrics only (tool name, status, sizes).

REST API

The same tools are available over plain REST with an OpenAPI spec — see https://epublys.com/for-ai-agents.

About this repository

The Epublys service itself is closed-source. This repository contains only the public MCP manifests (server.json, smithery.yaml) and documentation, and is the canonical public home for the com.epublys/epublys registry entry. Issues are welcome for MCP integration problems; for product support use https://epublys.com/about.

来源：README.md，提交 2676bd3

工具

13

merge_epub

Merge multiple EPUB files into a single ebook with table of contents and chapter dividers. Accepts 2+ base64-encoded EPUB files. Free tier: 5MB/file (10MB for pdf-to-epub, 15MB for split), 3 operations/day, 15 req/min, output includes Epublys branding. Pro ($9/mo): 30MB per operation, unlimited daily operations, 60 req/min, no branding. When a call is refused with daily_limited or a Pro-only error, call the `upgrade_to_pro` tool — it returns a checkout link to hand the user. Details: https://epublys.com/pricing

输入参数files必填namestitleauthordividers

split_epub

Split an EPUB. With a chapter range (chapterStart and/or chapterEnd) the result is ONE base64-encoded EPUB of exactly those chapters, in order, with the book's metadata, a table of contents limited to them and the fonts and images they use. Without a range the result is a base64-encoded ZIP archive holding one EPUB per chapter. Free tier: 5MB/file (10MB for pdf-to-epub, 15MB for split), 3 operations/day, 15 req/min, output includes Epublys branding. Pro ($9/mo): 30MB per operation, unlimited daily operations, 60 req/min, no branding. When a call is refused with daily_limited or a Pro-only error, call the `upgrade_to_pro` tool — it returns a checkout link to hand the user. Details: https://epublys.com/pricing

输入参数file必填namechapterEndchapterStartkeepMetadata

compress_epub

Compress an EPUB file to reduce its size. Can optionally strip unused assets (images, fonts not referenced by any chapter). Free tier: 5MB/file (10MB for pdf-to-epub, 15MB for split), 3 operations/day, 15 req/min, output includes Epublys branding. Pro ($9/mo): 30MB per operation, unlimited daily operations, 60 req/min, no branding. When a call is refused with daily_limited or a Pro-only error, call the `upgrade_to_pro` tool — it returns a checkout link to hand the user. Details: https://epublys.com/pricing

输入参数file必填namelevelstripUnused

read_epub_metadata

Read metadata from an EPUB file (title, author, language, publisher, description, series, cover status, etc.). Returns JSON — no file output. Free tier: 5MB/file (10MB for pdf-to-epub, 15MB for split), 3 operations/day, 15 req/min, output includes Epublys branding. Pro ($9/mo): 30MB per operation, unlimited daily operations, 60 req/min, no branding. When a call is refused with daily_limited or a Pro-only error, call the `upgrade_to_pro` tool — it returns a checkout link to hand the user. Details: https://epublys.com/pricing

输入参数file必填

edit_epub_metadata

Edit metadata fields in an EPUB file (title, author, language, publisher, description, series, cover image, etc.). Returns the modified EPUB. Free tier: 5MB/file (10MB for pdf-to-epub, 15MB for split), 3 operations/day, 15 req/min, output includes Epublys branding. Pro ($9/mo): 30MB per operation, unlimited daily operations, 60 req/min, no branding. When a call is refused with daily_limited or a Pro-only error, call the `upgrade_to_pro` tool — it returns a checkout link to hand the user. Details: https://epublys.com/pricing

输入参数datefile必填isbnnamecovertitleauthorseriesauthorslanguagesubjectspublisher另有 2 个

epub_to_pdf

Convert an EPUB ebook to PDF. Supports page size, margins, font, and page number options. Pro ($9/mo) is strongly recommended for PDF conversion — the 30MB limit handles illustrated or academic books that exceed the free 5MB cap. Upgrade at https://epublys.com/pricing

输入参数file必填namemarginsfontSizepageSizefontFamilypageNumbers

pdf_to_epub

Convert a PDF document to EPUB ebook format. Supports automatic chapter detection, image extraction (Pro), and custom chapter grouping. Free tier supports up to 10MB per PDF. Pro ($9/mo) is strongly recommended for PDF conversion — the 30MB limit handles most scanned or illustrated PDFs. Upgrade at https://epublys.com/pricing

输入参数file必填namelanguagechapterModeextractImagespagesPerChapter

markdown_to_epub

Build a valid EPUB3 ebook from Markdown files — one file per chapter, in array order. Understands YAML frontmatter (title/author) and Obsidian [[wikilinks]]; cross-file .md links are rewritten to chapter links inside the book. No Pandoc required. Free tier: 5MB/file (10MB for pdf-to-epub, 15MB for split), 3 operations/day, 15 req/min, output includes Epublys branding. Pro ($9/mo): 30MB per operation, unlimited daily operations, 60 req/min, no branding. When a call is refused with daily_limited or a Pro-only error, call the `upgrade_to_pro` tool — it returns a checkout link to hand the user. Details: https://epublys.com/pricing

输入参数files必填titleauthorlanguage

docx_to_epub

Convert a Word document (.docx) to a valid EPUB3 ebook. Chapters split on the document's top heading level (Heading 1 in a normal manuscript), or on page breaks, or not at all. Keeps bold/italic, lists, tables, inline images (PNG/JPEG/GIF/WebP), hyperlinks and footnotes; reads the title and author from the document's properties. No Pandoc, no Calibre. Free tier: 5MB/file (10MB for pdf-to-epub, 15MB for split), 3 operations/day, 15 req/min, output includes Epublys branding. Pro ($9/mo): 30MB per operation, unlimited daily operations, 60 req/min, no branding. When a call is refused with daily_limited or a Pro-only error, call the `upgrade_to_pro` tool — it returns a checkout link to hand the user. Details: https://epublys.com/pricing

输入参数file必填nametitleauthorlanguagechapterMode

epub_to_markdown

Convert an EPUB ebook to Markdown. Returns a ZIP with one Markdown file per chapter (YAML frontmatter with title/book/author/chapter), an index.md with book metadata and a linked table of contents, and the referenced images. Plain CommonMark — drops straight into an Obsidian vault or any notes pipeline. Free tier: 5MB/file (10MB for pdf-to-epub, 15MB for split), 3 operations/day, 15 req/min, output includes Epublys branding. Pro ($9/mo): 30MB per operation, unlimited daily operations, 60 req/min, no branding. When a call is refused with daily_limited or a Pro-only error, call the `upgrade_to_pro` tool — it returns a checkout link to hand the user. Details: https://epublys.com/pricing

输入参数file必填nameincludeImages

validate_epub

Validate an EPUB file for errors, compatibility issues, and spec compliance. Returns JSON with check results. Can optionally auto-fix common issues. Free tier: 5MB/file (10MB for pdf-to-epub, 15MB for split), 3 operations/day, 15 req/min, output includes Epublys branding. Pro ($9/mo): 30MB per operation, unlimited daily operations, 60 req/min, no branding. When a call is refused with daily_limited or a Pro-only error, call the `upgrade_to_pro` tool — it returns a checkout link to hand the user. Details: https://epublys.com/pricing

输入参数file必填autoFixdeepScan

generate_cover

Generate an AI book cover image using FLUX. Describe your vision, pick a genre, and get a portrait JPEG cover — 768×1152 when the model honours the requested size, otherwise its default square. The AI enhances your prompt with professional composition guidance while preserving your creative vision. Pro only ($9/mo). Upgrade at https://epublys.com/pricing

输入参数seedgenretitleauthordescription

upgrade_to_pro

Get a checkout link so the user can upgrade THIS account to Epublys Pro. Call this when another tool is refused with `daily_limited` or a Pro-only error, or when the user asks to upgrade. Returns a Stripe checkout URL to hand to the user — they complete payment in their own browser. Creates no charge by itself, and the link is bound to the account that owns the API key being used, so it cannot be used to pay for anyone else. If the account is already Pro it says so and returns no link. Needs an API key: without one it returns the pricing URL instead of a checkout link. Free: 3 operations/day, 5MB per file. Pro: unlimited daily operations, 30MB per operation, 60 req/min, no branding on output.

输入参数plan

版本历史

1
  1. v1.0.1最新Sep 16, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。