Readbook MCP Server

# 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: ```bash git clone https://github.com/yourusername/readbook-mcp.git cd readbook-mcp ``` 2. Install dependencies: ```bash npm install ``` 3. Build the project: ```bash npm run build ``` ## Configuration ### Claude Desktop Add this to your `claude_desktop_config.json`: ```json { "mcpServers": { "readbook": { "command": "node", "args": ["/path/to/readbook-mcp/build/index.js"] } } } ``` ### Cursor Add to your `.cursor/mcp.json`: ```json { "mcpServers": { "readbook": { "command": "node", "args": ["/path/to/readbook-mcp/build/index.js"] } } } ``` ## Development ### Build ```bash npm run build ``` ### Watch Mode ```bash npm run watch ``` ### Test with MCP Inspector ```bash 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 ```javascript // 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 ```javascript await client.callTool({ name: "get_book_content", arguments: { bookId: "book_001", chapterNumber: 1 } }); ``` ### Add Bookmark ```javascript await client.callTool({ name: "add_bookmark", arguments: { bookId: "book_001", chapterNumber: 3, pageNumber: 15, note: "Important concept about closures" } }); ``` ### Update Reading Progress ```javascript await client.callTool({ name: "update_reading_progress", arguments: { bookId: "book_001", chapterNumber: 5, pageNumber: 23, markChapterCompleted: true } }); ``` ## 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.