stewreads-mcp 0.1.0

Local StewReads MCP server for EPUB conversion

stewreads

Local-first StewReads MCP server for Claude Desktop on macOS.

Current Scope

• Local stdio MCP server (no backend calls)
• EPUB generation from markdown
• Save generated ebooks to a configured local directory
• Reuse current StewReads ebook-generation prompt

Not In Scope (Current Iteration)

• Email sending
• Gmail config
• PDF generation

Requirements

• Python 3.10+
• uv

macOS install:

brew install uv

Install (Recommended)

Install as a local tool:

uv tool install --force git+https://github.com/ankitvg/stewreads.git

This includes pandoc via pypandoc-binary, so no separate pandoc install is required.

Install (Repo Development)

uv sync

Configuration

Create ~/.config/stewreads/config.toml:

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

Optional environment overrides:

• STEWREADS_CONFIG_PATH (path to config file)
• STEWREADS_OUTPUT_DIR (overrides configured output dir)

Run MCP Server (Tool Install)

stewreads-mcp

Run MCP Server (Repo Development)

uv run stewreads-mcp

Claude Desktop (Mac) Example

Add to Claude Desktop MCP config:

{
  "mcpServers": {
    "stewreads": {
      "command": "/Users/you/.local/bin/stewreads-mcp",
      "env": {
        "STEWREADS_CONFIG_PATH": "/Users/you/.config/stewreads/config.toml"
      }
    }
  }
}

Exposed MCP Tools

• get_stew_prompt()
• get_stew_config()
• save_stew_config(output_dir)
• save_ebook(markdown, title, filename?, original_prompt?)

First-Time Claude Flow

1. Call get_stew_config().
2. If configured is false, ask the user for their preferred output directory and call save_stew_config(output_dir=...).
3. Call save_ebook(...) after config is set.

Dev Shell Safety

When running multi-step shell commands, you may see set -euo pipefail:

• -e: stop on command failure.
• -u: fail on unset variables.
• -o pipefail: fail if any command in a pipeline fails.