MCP 服务器

Readbook MCP Server

Enables AI assistants to help users manage their reading experience by searching books, tracking reading progress, managing bookmarks, and generating personalized recommendations and summaries.

README

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

Clone the repository:

git clone https://github.com/yourusername/readbook-mcp.git
cd readbook-mcp

Install dependencies:

npm install

Build the project:

npm run build

Configuration

Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "readbook": {
      "command": "node",
      "args": ["/path/to/readbook-mcp/build/index.js"]
    }
  }
}

Cursor

Add to your .cursor/mcp.json:

{
  "mcpServers": {
    "readbook": {
      "command": "node",
      "args": ["/path/to/readbook-mcp/build/index.js"]
    }
  }
}

Development

Build

npm run build

Watch Mode

npm run watch

Test with MCP Inspector

npm run 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

// Search by title
await client.callTool({
  name: "search_books",
  arguments: {
    query: "JavaScript",
    searchType: "title"
  }
});

// Search by author
await client.callTool({
  name: "search_books",
  arguments: {
    query: "Nicholas",
    searchType: "author"
  }
});

Get Book Content

await client.callTool({
  name: "get_book_content",
  arguments: {
    bookId: "book_001",
    chapterNumber: 1
  }
});

Add Bookmark

await client.callTool({
  name: "add_bookmark",
  arguments: {
    bookId: "book_001",
    chapterNumber: 3,
    pageNumber: 15,
    note: "Important concept about closures"
  }
});

Update Reading Progress

await client.callTool({
  name: "update_reading_progress",
  arguments: {
    bookId: "book_001",
    chapterNumber: 5,
    pageNumber: 23,
    markChapterCompleted: true
  }
});