This project provides a lightweight server to bridge WeChat Read (微信读书) data with Claude Desktop via the MCP protocol. It enables users to seamlessly access and interact with their reading notes and history within Claude, facilitating deeper understanding and knowledge management.

How It Works

The server acts as an intermediary, fetching data from WeChat Read through API calls. It formats this data to be compatible with the MCP protocol, allowing AI assistants like Claude Desktop to query and process reading materials, notes, and search for specific content across a user's library. The design emphasizes real-time, on-demand data retrieval without local storage, ensuring a stateless and efficient operation.

Quick Start & Requirements

• Install: Clone the repository, then run npm install (or npm install --registry=https://registry.npmmirror.com for faster downloads).
• Prerequisites: Node.js (v16+).
• Configuration: Obtain WeChat Read cookies from browser developer tools and set them in a .env file as WEREAD_COOKIE.
• Run: Build with npm run build, then start with node build/index.js.
• MCP Client: Configure in ~/.cursor/mcp.json (or equivalent) with the command and path to the built server.
• Docs: GitHub Repository

Highlighted Details

• Tools: Supports fetching bookshelves, notebooks, book notes, book info, searching notes, and recent reads.
• Integration: Designed for seamless integration with MCP-compatible clients like Claude Desktop.
• Workflow: Enables a "input-organize-precipitate" knowledge workflow, aiding deep reading analysis and content creation.
• Data Handling: Organizes notes by chapter and supports searching across highlights and reviews.

Maintenance & Community

The project is maintained by freestylefly. Further community engagement details (Discord, Slack, roadmap) are not explicitly mentioned in the README.

Licensing & Compatibility

The project's license is not specified in the README. Compatibility for commercial use or closed-source linking would depend on the eventual license.

Limitations & Caveats

The project relies on WeChat Read's web interface cookies, which may change and require updates to the server. Error handling for API failures and cookie expiration is noted as an area for improvement. The README does not specify a license, which could impact commercial adoption.