freestylefly/mcp-server-weread

API development

This page was translated automatically. Technical details may differ from the original. View the original

584 stars 61 forks Quality 69 Trend 21MIT

Repository Install

WeChat Reading MCP

Overview

WeChat Reading MCP Server is a tool that provides MCP (Model Context Protocol) services for WeChat Reading, supporting the provision of books, notes, and underlined data from WeChat Reading to MCP-compatible large language model clients such as Cursor and Claude Desktop. - Get bookshelf information from WeChat Reading - Search books in the shelves - Get notes and underlined books - Get popular book reviews - Support organizing notes and underlining by chapter - Seamless integration with LLM clients that support the MCP protocol 1. - Retrieve all books on the user's bookshelf - Return basic book information, including title, author, translator, and classification 2. - Search books on the user's bookshelf by keyword - supports fuzzy and exact matching - optionally includes details - can set the maximum number of results 3. - Retrieve all underlines and notes for the specified book - Support for organizing results by chapter - Support for filtering underline styles - Return structured data for easier understanding by LLM 4. - Get popular reviews of a specific book - Supports setting return count - Supports paginated browsing - Includes ratings, likes, and reviewer information See also: - Building a private library in Cursor with WeChat Reading MCP—amazing! - Weread MCP Server user guide 1. Open Claude Desktop 2. Go to Settings -> MCP Configuration 3. Add a tool using the following JSON configuration:

Overview (machine translated)

A tool that provides MCP services for WeChat Reading

Functional Features

Get bookshelf information from WeChat Reading
Search the books in the bookshelf
Take notes and underline books from the book
Get popular reviews of books
Supports organizing notes and underlining by chapter
Seamless integration with LLM clients that support the MCP protocol

Main Tools

get_bookshelf - Retrieve all books on the user’s bookshelf

Return basic book information, including title, author, translator, and classification

search_books - Search for books on users’ bookshelves by keywords

Supports fuzzy matching and precise matching
Optionally, whether to include detailed information
Maximum number of results can be set

get_book_notes_and_highlights - Get all underlines and notes from the specified book

Supports organizing results by chapter
Supports filtering stroke styles
Returns structured data to facilitate LLM understanding

get_book_best_reviews - Get popular reviews of the specified book

Supports setting the number of returns required
Supports paginated browsing
Includes ratings, likes, and reviewer information

Installation and Use

Prerequisites

Node.js 16.x or later
WeChat Reading account and valid cookies

Installation Tutorial

Integration with Claude Desktop

There are several ways to integrate with Claude Desktop:

Method One: Use through NPX (the simplest, recommended)

Open Claude Desktop
Go to Settings -> MCP Configuration
Add tools using the following JSON configuration:

Method 2: Use after global installation

Global Installation Package:
Using in the Claude configuration:

Tip: Providing environment variables directly in Claude configuration is more convenient without setting up .env files. Recommended.

CookieCloud Configuration Instructions

To solve the problem of frequent cookie expirations, you need to reacquire and update environment variables. This project supports the CookieCloud service to automatically synchronize and update cookies. CookieCloud is an open-source cross-browser cookie synchronization tool that supports self-hosted servers.

Configuration Steps:

Install browser plugins Edge Store: CookieCloud for Edge Chrome Store: CookieCloud for Chrome

Configuring the CookieCloud plugin

This page was translated automatically. Technical details may differ from the original.

Install

npx -y mcp-server-weread

New to MCP? Start with the mcpskill.org guide →

Configuration

{
     "mcpServers": {
       "mcp-server-weread": {
         "command": "npx",
         "args": ["-y", "mcp-server-weread"],
         "env": {
           // 方式1：使用Cookie Cloud（推荐）
           "CC_URL": "https://cc.chenge.ink",  // Cookie Cloud的URL
           "CC_ID": "您的ID",                   // Cookie Cloud的ID
           "CC_PASSWORD": "您的密码"            // Cookie Cloud的密码
           
           // 或方式2：直接提供Cookie
           // "WEREAD_COOKIE": "您的微信读书Cookie"
         }
       }
     }
   }