mcp-server-weread

```html <p align="center"><img src= "https://cdn.canghecode.com/blog/%E5%BE%AE%E4%BF%A1%E8%AF%BB%E4%B9%A6MCP%20bac.png" alt="MaxKB" width="300" /></p> <h3 align="center">A tool that provides MCP services for WeRead</h3> <p align="center"> <a href="https://opensource.org/license/MIT"><img src="https://img.shields.io/github/license/freestylefly/mcp-server-weread?color=rgb(25%2C%20121%2C%20255)" alt="The MIT License"></a> <a href=""><img src="https://img.shields.io/github/forks/freestylefly/mcp-server-weread?color=green" alt="Forks"></a> <a href="https://canghecode.com/"><img src="https://img.shields.io/badge/介绍-%E5%AE%98%E7%BD%91-green" alt="Official"></a> <a href="https://github.com/laigeoffer/pmhub"><img src="https://img.shields.io/github/stars/freestylefly/mcp-server-weread?style=flat-square&color=rgb(25%2C%20121%2C%20255)" alt="Stars"></a> <a href="https://mp.weixin.qq.com/s/NQslbUBgWIBMyvTIa3PfYQ"><img src="https://img.shields.io/badge/WeReadMCP-教程-blue" alt="Experience"></a> </p> <hr/> WeRead MCP Server is a tool that provides MCP (Model Context Protocol) services for WeRead, supporting the provision of WeRead books, notes, and highlight data to large language model clients that support MCP, such as Cursor and Claude Desktop. ## Features - Get bookshelf information from WeRead - Search for books in the bookshelf - Get notes and highlights of books - Get popular book reviews - Support organizing notes and highlights by chapter - Seamless integration with LLM clients that support the MCP protocol ## Main Tools 1. **get_bookshelf** - Get all books on the user's bookshelf - Returns basic book information, including title, author, translator, and category, etc. 2. **search_books** - Search for books on the user's bookshelf by keyword - Supports fuzzy matching and exact matching - Optional whether to include detailed information - Can set the maximum number of results 3. **get_book_notes_and_highlights** - Get all highlights and notes for a specified book - Supports organizing results by chapter - Supports filtering highlight styles - Returns structured data for LLM understanding 4. **get_book_best_reviews** - Get popular book reviews for a specified book - Supports setting the number of returns - Supports paged browsing - Includes rating, likes, and reviewer information ## Installation and Usage ### Prerequisites - Node.js 16.x or higher - WeRead account and valid Cookie ### Installation Guide See: - [用微信读书MCP在Cursor中构建私人图书馆，太哇塞了！](https://mp.weixin.qq.com/s/NQslbUBgWIBMyvTIa3PfYQ) - [Weread MCP Server 使用指南](https://chenge.ink/article/post20250505) ### Integration with Claude Desktop There are several ways to integrate with Claude Desktop: #### Method 1: Use via npx (simplest, recommended) 1. Open Claude Desktop 2. Go to Settings -> MCP Configuration 3. Add a tool, using the following JSON configuration: ```json { "mcpServers": { "mcp-server-weread": { "command": "npx", "args": ["-y", "mcp-server-weread"], "env": { // Method 1: Use Cookie Cloud (recommended) "CC_URL": "https://cc.chenge.ink", // Cookie Cloud URL "CC_ID": "您的ID", // Cookie Cloud ID "CC_PASSWORD": "您的密码" // Cookie Cloud Password // Or Method 2: Provide Cookie directly // "WEREAD_COOKIE": "您的微信读书Cookie" } } } } ``` #### Method 2: Use after global installation 1. Globally install the package: ```bash npm install -g mcp-server-weread ``` 2. Use in Claude configuration: ```json { "mcpServers": { "mcp-server-weread": { "command": "mcp-server-weread", "env": { // Configure environment variables in the same way as above } } } } ``` > Tip: Providing environment variables directly in the Claude configuration is more convenient and does not require setting a .env file, so it is recommended. ## CookieCloud Configuration Instructions In order to solve the problem of frequent Cookie expiration, which requires re-acquiring and updating environment variables. This project supports [CookieCloud](https://github.com/easychen/CookieCloud) service to automatically synchronize and update Cookies. CookieCloud is an open-source cross-browser Cookie synchronization tool that supports self-built servers. ### Configuration Steps: Install the browser extension Edge Store: [CookieCloud for Edge](https://microsoftedge.microsoft.com/addons/detail/cookiecloud/bffenpfpjikaeocaihdonmgnjjdpjkeo) Chrome Store: [CookieCloud for Chrome](https://chromewebstore.google.com/detail/cookiecloud/ffjiejobkoibkjlhjnlgmcnnigeelbdl) ### Configure the CookieCloud Extension Server Address: Use the default server https://cc.chenge.ink or fill in the address of your self-built server Click "Generate Password Automatically" Fill in "weread" in the synchronization domain keywords Click "Save" and then click "Manual Sync" to ensure the configuration takes effect [Optional] If you need the extension to automatically keep alive, you can fill in https://weread.qq.com in the keep-alive settings, and the extension will automatically refresh the Cookie Configure CookieCloud variables in the MCP Json: CC_URL=Your CookieCloud server address (or use my default server address https://cc.chenge.ink) CC_ID=Your CookieCloud user UUID CC_PASSWORD=Your CookieCloud password Note: After configuring CookieCloud, the system will prioritize using CookieCloud to obtain the Cookie, and will only use the value of the WEREAD_COOKIE environment variable if it fails to obtain the Cookie. ## Cookie Acquisition Method The WeRead Cookie can be obtained through the following steps: 1. Log in to the [WeRead web version](https://weread.qq.com/) using the Chrome browser 2. Press F12 to open the developer tools, switch to the Network tab 3. Refresh the page, find the weread.qq.com request in the request list 4. Find the Cookie field in the Headers, copy its complete content 5. Add the copied content to the WEREAD_COOKIE variable in the MCP Json or .env file ## Usage Examples Here are some examples of conversations with LLM: **Get bookshelf information** ``` User: Help me check my WeRead bookshelf LLM: I will get your WeRead bookshelf information. [LLM calls the get_bookshelf tool] I have obtained 208 books from your WeRead bookshelf. Here are some of the books: 1. "The Hidden Self" - David Eagleman 2. "Thinking, Fast and Slow" - Daniel Kahneman 3. "Sapiens: A Brief History of Humankind" - Yuval Noah Harari ... ``` **Search for specific books** ``` User: Help me find books about psychology LLM: I will search your bookshelf for books related to psychology. [LLM calls the search_books tool with the parameter keyword="psychology"] On your bookshelf, I found 3 books related to psychology: 1. "Thinking, Fast and Slow" - Daniel Kahneman (Progress: 75%) 2. "Crowds: A Study of the Popular Mind" - Gustave Le Bon (Progress: 50%) 3. "Psychology and Life" - Richard Griggs (Progress: 30%) Which book would you like to know more about? ``` **Get notes and highlights** ``` User: Help me organize the notes for the book "Thinking, Fast and Slow" LLM: I will get the notes and highlights for "Thinking, Fast and Slow". [LLM calls the search_books tool to find the book ID] [LLM calls the get_book_notes_and_highlights tool] Here are your notes and highlights in "Thinking, Fast and Slow" (organized by chapter): Chapter 1: System 1 and System 2 - Highlight: "System 1 operates unconsciously and quickly, with little effort, no sense of voluntary control." - Your note: "System 1 is responsible for intuition and quick judgments, System 2 is responsible for slow, rational thinking." Chapter 3: Anchoring Effect - Highlight: "The anchoring effect refers to the tendency to rely too heavily on the first piece of information offered (the 'anchor') when making decisions." ... ``` **Get popular book reviews** ``` User: What are some popular book reviews for "Principles"? LLM: I will find popular book reviews for "Principles" for you. [LLM calls the search_books tool to find the book ID] [LLM calls the get_book_best_reviews tool] Here are the popular book reviews for "Principles": 1. Reviewer "Thinker" (Rating: 5 stars): "This is a book about how to think. Dalio summarizes his years of experience into actionable principles to help us make better decisions. I especially like his view on 'Pain + Reflection = Progress', which is very practical." 👍 182 | 💬 23 2. Reviewer "Investment Learner" (Rating: 4 stars): "The essence of the Bridgewater Fund founder's thoughts, worth reading repeatedly. The work principles part of the book is especially helpful for managers, it is recommended to read the life principles first, and then the work principles." 👍 94 | 💬 12 ... ``` ## IX. Friend Links - [mcp-server-weread](https://github.com/ChenyqThu/mcp-server-weread) : 🚀 A tool that provides MCP (Model Context Protocol) services for WeRead, supporting the provision of WeRead books, notes, and highlight data to large language model clients that support MCP, such as Claude Desktop. - [CodeCanvas](https://github.com/freestylefly/CodeCanvas) : 📚 This code repository is a technical summary of the author Canghe's years of experience in first-line Internet Java development, aiming to provide you with a clear and detailed learning tutorial, with more emphasis on writing Java core content. 💪🏻 - [PmHub](https://github.com/laigeoffer/pmhub) : 🔥 PmHub is a microservice intelligent project management system based on SpringCloud & LLM. This project aims to help partners quickly master the architecture design and development process of microservice/distributed projects. If you want to get a satisfactory offer in campus recruitment or social recruitment, PmHub will be a very nice choice. ## X. Acknowledgements This project is forked from ChenyqThu's [mcp-server-weread](https://github.com/ChenyqThu/mcp-server-weread) project, with some minor modifications, and it suddenly became 🔥. I would also like to ask everyone to star the author's original GitHub project. In addition, I will also synchronize ChenyqThu's new updates, and the project will continue to update the usage tutorial. Thank you for your love. ## XI. Star Trend Chart [](https://star-history.com/#freestylefly/mcp-server-weread&Date) ## XII. Public Account Search for **苍何** on WeChat or scan the QR code below to follow Canghe's original public account, reply **AI** to discuss AI with 5000+ friends and learn MCP together.  ## XIII. License [MIT License (MIT)](https://opensource.org/licenses/MIT)<hr/> The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. Copyright (c) 2025-2026 mcp-server-weread ```