Stewreads Local

炖菜

StewReads Pixel Art

StewReads是一个本地MCP服务器，可以将人工智能对话转换为干净、格式良好的电子书。一切都在你的机器上运行，不需要帐户，也不需要云后端。从您的聊天中生成EPUB文件，并将其直接发送到Kindle或任何电子邮件地址。适用于Claude Desktop和其他MCP兼容客户端。

网站与本地套餐

StewReads的官方网站是 stewreads.com这个PyPI包， stewreads-mcp，是本地第一个MCP版本，适合那些想在自己的机器上从Claude Desktop运行电子书生成的人。安装此软件包不会连接到StewReads云后端。

特性

• 本地第一台无登录或云后端的MCP服务器
• 本地stdio MCP服务器（无后端调用）
• 从降价生成EPUB
• 将生成的电子书保存到配置的本地目录
• 通过内置的Gmail SMTP（应用程序密码）通过电子邮件发送生成的EPUB文件
• 通过ElevenLabs TTS生成可选MP3有声读物

用例

• 与克劳德一起学习一个新话题，并将讨论变成一本精美的电子书，供以后阅读。
• 在飞行前生成一本重点电子书，并在电子阅读器上离线阅读。
• 将长时间的计划或研究聊天变成一个干净的文档，您可以随时重新访问。
• 通过辅导或面试准备对话创建Kindle准备的学习笔记。
• 通过电子邮件与朋友或队友保存和分享人工智能生成的解释。

需求

• Python 3.10+
• uv用于回购开发

从PyPI安装

安装已发布的软件包：

pip install stewreads-mcp

macOS安装：

brew install uv

来自Repo的设置

从该存储库克隆并安装：

git clone git@github.com:ankitvg/stewreads-local.git
cd stewreads-local
uv sync

这包括pandoc via pypandoc-binary，因此不需要单独安装pandoc。

更新依赖关系

uv sync

配置

创建 ~/.config/stewreads/config.toml:

[paths]
output_dir = "/Users/you/Projects/generated_books"

[email]
from_email = "you@gmail.com"
default_to_email = "kindle-or-reader@example.com"

重要信息（Kindle用户）： 为了使Kindle交付正常工作，您必须添加您的 from_email 致你的 批准的个人文档电子邮件列表 在您的亚马逊帐户设置中。否则，亚马逊将出于安全考虑阻止传入的电子书。

可选环境覆盖：

• STEWREADS_CONFIG_PATH （配置文件的路径）
• STEWREADS_OUTPUT_DIR （覆盖配置的输出目录）
• STEWREADS_FROM_EMAIL （覆盖发件人电子邮件）
• STEWREADS_DEFAULT_TO_EMAIL （覆盖默认收件人电子邮件）

发送电子邮件所需的密码：

• STEWREADS_GMAIL_APP_PASSWORD （Gmail应用程序密码）

有声读物环境变量（仅在以下情况下使用 save_ebook(..., create_audio=true)):

• ELEVENLABS_API_KEY （需要生成MP3文件）
• ELEVENLABS_VOICE_ID （可选语音覆盖）

有声读物默认值：

• 声音：瑞秋(21m00Tcm4TlvDq8ikWAM)
• 型号： eleven_multilingual_v2
• 输出格式： mp3_44100_128

运行MCP服务器

uv run stewreads-mcp

克劳德桌面（Mac）示例

添加到克劳德桌面 claude_desktop_config.json MCP配置：

{
  "mcpServers": {
    "stewreads": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/you/Projects/stewreads-local",
        "run",
        "stewreads-mcp"
      ],
      "env": {
        "STEWREADS_CONFIG_PATH": "/Users/you/.config/stewreads/config.toml",
        "STEWREADS_GMAIL_APP_PASSWORD": "your-16-char-app-password",
        "ELEVENLABS_API_KEY": "your-elevenlabs-api-key",
        "ELEVENLABS_VOICE_ID": "21m00Tcm4TlvDq8ikWAM"
      }
    }
  }
}

暴露的MCP工具

• get_stew_prompt()
• get_stew_config()
• get_email_status()
• save_stew_config(output_dir)
• save_ebook(markdown, title, filename?, original_prompt?, create_audio?)
• email_ebook(to_email?, ebook_path?, subject?, body?)

异步有声读物行为

当你打电话的时候 save_ebook(..., create_audio=true):

• EPUB保存首先完成，Claude可以立即返回该结果。
• MP3生成在后台继续，并可能在响应后仍在运行。
• 回应包括 audio_status="generating" 和一个 audio_path 您可以检查输出目录。

第一次克劳德流

1. 呼叫 get_stew_config().
2. 如果 configured 是 false，询问用户首选的输出目录并调用 save_stew_config(output_dir=...).
3. 呼叫 save_ebook(...) 设置配置后。
4. 呼叫 get_email_status() 在发送之前。
5. 呼叫 email_ebook(...) 发送最新的EPUB（或指定 ebook_path).

测试（本地开发）

运行测试：

uv run --with pytest python -m pytest -q tests

可选皮棉检查：

uv run --with ruff ruff check src tests

开发外壳安全

运行多步shell命令时，您可能会看到 set -euo pipefail:

• -e：命令失败时停止。
• -u：在未设置的变量上失败。
• -o pipefail：如果管道中的任何命令失败，则失败。