Readbook MCP Server

A Model Context Protocol (MCP) server for reading books, transformed from the Telegram Mini App readbook project.

Features

This MCP server provides the following tools for AI assistants to help with reading:

Tools

• search_books - Search for books by title, author, or category

• get_book_content - Get chapter content of a specific book

• add_bookmark - Add a bookmark at a specific location

• get_bookmarks - Get all bookmarks for a book

• get_reading_progress - Get reading progress for a book

• update_reading_progress - Update reading progress

• get_reading_stats - Get overall reading statistics

Resources

• book_list - List of all available books

• reading_progress_summary - Summary of reading progress across all books

Prompts

• reading_recommendation - Get personalized book recommendations

• reading_summary - Generate a reading summary report

Installation

From Source

1. Clone the repository:

2. Install dependencies:

3. Build the project:

Configuration

Claude Desktop

Add this to your claude_desktop_config.json:

Cursor

Add to your .cursor/mcp.json:

Development

Build

Watch Mode

Test with MCP Inspector

Mock Data

The server comes with pre-loaded mock books:

• JavaScript高级程序设计 by Nicholas C. Zakas (25 chapters)

• 人类简史 by 尤瓦尔·赫拉利 (20 chapters)

• 百年孤独 by 加西亚·马尔克斯 (20 chapters)

API Usage Examples

Search Books

Get Book Content

Add Bookmark

Update Reading Progress

Architecture

This MCP server is built using:

• @modelcontextprotocol/sdk - Official MCP TypeScript SDK

• TypeScript - Type-safe development

• Zod - Schema validation

• Stdio transport - Standard input/output communication

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.