Md Book

MD图书工具

一个具有DI/SOA架构和MCP服务器支持Claude Code集成的markdown阅读器和作家。

特性

• 多格式支持：mdBook、GitBook、Leanpub、Bookdown和自动检测
• YAML前端编辑器：提取元数据（标题、作者、日期、草稿状态）
• 交互式阅读器：带章节跳转的终端导航
• 书籍写作：初始化项目、添加章节、生成TOC
• MCP 服务器：将图书操作作为人工智能助手的工具

建筑

mdbook/
├── domain/           # Core entities (Book, Chapter, ChapterMetadata)
├── services/         # Business logic with interface protocols
│   ├── interfaces.py # IBookService, IReaderService, IWriterService, IStructureService
│   ├── book_service.py
│   ├── reader_service.py
│   ├── writer_service.py
│   └── structure_service.py
├── repositories/     # Data access layer
│   ├── interfaces.py # IFileRepository, IConfigRepository
│   ├── file_repository.py
│   └── config_repository.py
├── infrastructure/   # DI container and composition root
│   └── container.py  # ServiceContainer with lazy singleton resolution
├── mcp/              # Model Context Protocol server
│   └── server.py     # Exposes book operations as MCP tools
└── cli.py            # Unified Click-based CLI

安装

使用紫外线（推荐）

cd book-reader
uv pip install -e .

使用pip

cd book-reader
pip install -e .

这将安装单 mdbook 命令及其所有子命令。

快速开始

# Read a book (pass book path as argument)
mdbook read /path/to/book

# Or use --book/-b global option
mdbook --book /path/to/book read

# Show book info
mdbook info /path/to/book

# Create a new book
mdbook init ./my-book -t "My Book Title" -a "Author Name"

# Add a chapter
mdbook new-chapter ./my-book -t "Introduction"

# Regenerate table of contents
mdbook toc ./my-book

# Start MCP server for a specific book
mdbook serve-mcp /path/to/book

# Auto-configure Claude Code MCP integration
mdbook setup /path/to/book

命令参考

mdbook [OPTIONS] COMMAND [ARGS]

Commands:
  read         Read a markdown book interactively
  info         Show book information
  init         Initialize a new book project
  new-chapter  Add a new chapter to a book
  toc          Regenerate table of contents
  serve-mcp    Start MCP server for Claude Code
  setup        Auto-configure Claude Code MCP integration

Global Options:
  -b, --book PATH  Book directory (used by all commands)
  --version        Show version and exit
  --help           Show help message and exit

读

mdbook read [BOOK] [OPTIONS]

Arguments:
  BOOK         Book directory (or use global --book option)

Options:
  -c, --chapter NUM    Start at specific chapter

初始化

mdbook init PATH [OPTIONS]

Arguments:
  PATH         Directory to create book in

Options:
  -t, --title TEXT     Book title (required)
  -a, --author TEXT    Author name (required)

新篇章

mdbook new-chapter [BOOK] [OPTIONS]

Arguments:
  BOOK         Book directory (or use global --book option)

Options:
  -t, --title TEXT     Chapter title (required)
  -d, --draft          Mark as draft

设置

mdbook setup [BOOK]

Arguments:
  BOOK         Book directory (or use global --book option)

Auto-configures Claude Code MCP integration by updating .mcp.json
in the project directory. Creates the file if it doesn't exist or
adds/updates the mdbook server configuration.

MCP服务器集成

MCP服务器将图书操作作为Claude Code和其他人工智能助手的工具公开。

可用的MCP工具

Claude代码配置

添加到您的 .mcp.json:

{
  "mcpServers": {
    "mdbook": {
      "command": "mdbook",
      "args": ["serve-mcp"]
    }
  }
}

或者使用紫外线：

{
  "mcpServers": {
    "mdbook": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/book-reader", "mdbook", "serve-mcp"]
    }
  }
}

支持的书籍格式

需求

• Python 3.10+
• 点击、丰富、降价、pyyaml、mcp

许可证

MIT许可证

版本历史记录

• v1.0.0 -DI/SOA架构的首次公开发布，统一 mdbook CLI、MCP服务器集成、带book参数的多书支持和 --book/-b 全局选项， setup 用于Claude Code MCP自动配置、多格式支持（mdBook、GitBook、Leanpub、Bookdown）和YAML frontmatter解析的命令