{"type":"mcp_server","name":"mcp-server-weread","description":"WeChat Read MCP Server. Handles Model Context Protocol for WeChat Reading app.","category":"Developer Tools","language":"JavaScript","stars":560,"forks":43,"owner":"freestylefly","github_url":"https://github.com/freestylefly/mcp-server-weread","homepage":null,"setup":"## Setup\n\nThis section details how to install and configure `mcp-server-weread` to work with WeChat Read and integrate with LLM clients like Claude Desktop.\n\n### Prerequisites\n\n*   **Node.js:** Version 16.x or higher is required. You can download it from [nodejs.org](https://nodejs.org/).\n*   **WeChat Read Account:** You need an active WeChat Read account.\n*   **Valid WeChat Read Cookie:**  A valid cookie is necessary to authenticate with WeChat Read. See \"Cookie Acquisition\" for instructions.\n\n### Installation\n\nThere are two primary methods for installing and using `mcp-server-weread`: using `npx` (recommended for simplicity) or installing it globally.\n\n#### Method 1: Using `npx` (Recommended)\n\nThis method avoids global installation and is generally easier to manage.\n\n1.  **Open Claude Desktop:** Launch your Claude Desktop application.\n2.  **Navigate to MCP Configuration:** Go to the settings or configuration section within Claude Desktop and find the MCP configuration area.\n3.  **Add a New Tool:** Add a new tool with the following JSON configuration:\n\n    ```json\n    {\n      \"mcpServers\": {\n        \"mcp-server-weread\": {\n          \"command\": \"npx\",\n          \"args\": [\"-y\", \"mcp-server-weread\"],\n          \"env\": {\n            // Option 1: Using CookieCloud (Recommended)\n            \"CC_URL\": \"https://cc.chenge.ink\",  // CookieCloud URL (or your self-hosted URL)\n            \"CC_ID\": \"your_cookiecloud_id\",    // Your CookieCloud ID\n            \"CC_PASSWORD\": \"your_cookiecloud_password\" // Your CookieCloud Password\n    \n            // Option 2: Directly provide the WeChat Read Cookie (Alternative)\n            // \"WEREAD_COOKIE\": \"your_weread_cookie\"\n          }\n        }\n      }\n    }\n    ```\n\n    *   **CookieCloud (Recommended):**  Using CookieCloud is the preferred method for managing your WeChat Read cookie, as it automatically updates the cookie when it expires.  See the \"CookieCloud Configuration\" section for setup instructions.  Replace `\"your_cookiecloud_id\"` and `\"your_cookiecloud_password\"` with your actual CookieCloud credentials.\n    *   **Direct Cookie (Alternative):** If you choose not to use CookieCloud, you can directly provide your WeChat Read cookie.  Replace `\"your_weread_cookie\"` with the actual cookie value.\n\n#### Method 2: Global Installation\n\n1.  **Install Globally:** Open your terminal and run the following command:\n\n    ```bash\n    npm install -g mcp-server-weread\n    ```\n\n2.  **Configure in Claude Desktop:**  In Claude Desktop's MCP configuration, add a new tool with the following JSON:\n\n    ```json\n    {\n      \"mcpServers\": {\n        \"mcp-server-weread\": {\n          \"command\": \"mcp-server-weread\",\n          \"env\": {\n            // Option 1: Using CookieCloud (Recommended)\n            \"CC_URL\": \"https://cc.chenge.ink\",  // CookieCloud URL (or your self-hosted URL)\n            \"CC_ID\": \"your_cookiecloud_id\",    // Your CookieCloud ID\n            \"CC_PASSWORD\": \"your_cookiecloud_password\" // Your CookieCloud Password\n    \n            // Option 2: Directly provide the WeChat Read Cookie (Alternative)\n            // \"WEREAD_COOKIE\": \"your_weread_cookie\"\n          }\n        }\n      }\n    }\n    ```\n\n    *   As with the `npx` method, configure either CookieCloud or provide the WeChat Read cookie directly.\n\n### CookieCloud Configuration\n\nCookieCloud helps manage WeChat Read cookies automatically.\n\n1.  **Install Browser Extension:**\n    *   **Edge:** [CookieCloud for Edge](https://microsoftedge.microsoft.com/addons/detail/cookiecloud/bffenpfpjikaeocaihdonmgnjjdpjkeo)\n    *   **Chrome:** [CookieCloud for Chrome](https://chromewebstore.google.com/detail/cookiecloud/ffjiejobkoibkjlhjnlgmcnnigeelbdl)\n2.  **Configure the Extension:**\n    *   **Server Address:** Use the default server `https://cc.chenge.ink` or your self-hosted server address.\n    *   **Generate Password:** Click \"自动生成密码\" (automatically generate password).\n    *   **Synchronization Domain Keyword:** Enter `weread`.\n    *   **Save and Synchronize:** Click \"保存\" (save), then \"手动同步\" (manually synchronize) to ensure the configuration takes effect.\n    *   **Optional: Auto-Keep Alive:**  Enter `https://weread.qq.com` in the \"保活\" (keep alive) field to automatically refresh the cookie.\n3.  **Configure Environment Variables:** In the MCP JSON configuration (as shown in the Installation section), set the following environment variables:\n\n    *   `CC_URL`: Your CookieCloud server address (e.g., `https://cc.chenge.ink`).\n    *   `CC_ID`: Your CookieCloud user UUID.\n    *   `CC_PASSWORD`: Your CookieCloud password.\n\n    **Note:** If CookieCloud is configured, the system will prioritize using it to obtain the cookie. If CookieCloud fails, it will fall back to the `WEREAD_COOKIE` environment variable.\n\n### Cookie Acquisition\n\nIf you choose not to use CookieCloud, you need to manually obtain the WeChat Read cookie.\n\n1.  **Log in to WeChat Read Web:** Use Chrome or another browser to log in to the [WeChat Read web version](https://weread.qq.com/).\n2.  **Open Developer Tools:** Press F12 to open the browser's developer tools.\n3.  **Navigate to Network Tab:** Switch to the \"Network\" tab.\n4.  **Refresh the Page:** Refresh the page.\n5.  **Find WeChat Read Request:** In the request list, find a request to `weread.qq.com`.\n6.  **Copy Cookie:** In the \"Headers\" section of the request, find the \"Cookie\" field and copy its entire content.\n7.  **Set `WEREAD_COOKIE`:** Add the copied cookie content to the `WEREAD_COOKIE` environment variable in your MCP JSON configuration (as shown in the Installation section).\n\n### Environment Variables\n\nThe following environment variables are used by `mcp-server-weread`:\n\n*   `WEREAD_COOKIE`: (Optional, if not using CookieCloud) Your WeChat Read cookie.\n*   `CC_URL`: (Optional, if using CookieCloud) The URL of your CookieCloud server. Defaults to `https://cc.chenge.ink`.\n*   `CC_ID`: (Optional, if using CookieCloud) Your CookieCloud user ID.\n*   `CC_PASSWORD`: (Optional, if using CookieCloud) Your CookieCloud password.\n\n**Important Notes:**\n\n*   **Security:**  Treat your WeChat Read cookie and CookieCloud credentials as sensitive information.  Avoid committing them to public repositories.\n*   **Cookie Expiration:** WeChat Read cookies expire periodically.  Using CookieCloud is highly recommended to automate cookie renewal.\n*   **Troubleshooting:** If you encounter issues, double-check that your Node.js version meets the requirements, that your cookie is valid, and that your CookieCloud configuration is correct.","tools":"## Available Tools\n\nThis tool provides the following functionalities to interact with your WeChat Read library:\n\n- **Get Bookshelf Information:**\n  - Tool: `get_bookshelf`\n  - Description: Retrieves a list of all books on your WeChat Read bookshelf.\n  - Output: Returns basic information for each book, including title, author, translator, and category.\n  - Example Usage: An LLM can use this to provide a summary of your library or to allow you to select a book for further analysis.\n\n- **Search Books:**\n  - Tool: `search_books`\n  - Description: Searches your WeChat Read bookshelf for books matching a given keyword.\n  - Features:\n    - Supports both fuzzy and exact matching.\n    - Can include detailed book information in the results.\n    - Allows setting a maximum number of results.\n  - Example Usage:\n    ```\n    User: \"Find books about psychology.\"\n    LLM: \"[LLM calls search_books tool with keyword='psychology']\"\n    LLM: \"I found 3 books related to psychology: Thinking, Fast and Slow; The Crowd; Psychology and Life.\"\n    ```\n\n- **Get Book Notes and Highlights:**\n  - Tool: `get_book_notes_and_highlights`\n  - Description: Retrieves all highlights and notes for a specified book.\n  - Features:\n    - Organizes results by chapter.\n    - Supports filtering by highlight style.\n    - Returns structured data suitable for LLM processing.\n  - Example Usage:\n    ```\n    User: \"Summarize my notes from 'Thinking, Fast and Slow'.\"\n    LLM: \"[LLM calls get_book_notes_and_highlights tool for 'Thinking, Fast and Slow']\"\n    LLM: \"Here are your notes and highlights from 'Thinking, Fast and Slow', organized by chapter:\"\n    LLM: \"Chapter 1: System 1 and System 2 - Highlight: 'System 1 operates automatically and quickly, with little or no effort and no sense of voluntary control.' - Note: 'System 1 is responsible for intuition and quick judgments, while System 2 is responsible for slow, rational thinking.'\"\n    ```\n\n- **Get Book Best Reviews:**\n  - Tool: `get_book_best_reviews`\n  - Description: Retrieves popular reviews for a specified book.\n  - Features:\n    - Supports setting the number of reviews to return.\n    - Supports paginated browsing.\n    - Includes rating, number of likes, and reviewer information.\n  - Example Usage:\n    ```\n    User: \"What are some popular reviews for 'Principles'?\"\n    LLM: \"[LLM calls get_book_best_reviews tool for 'Principles']\"\n    LLM: \"Here are some popular reviews for 'Principles': Reviewer 'Thinker' (5 stars): 'A book about how to think. Dalio summarizes his years of experience into actionable principles to help us make better decisions...' (182 likes, 23 comments)\"\n    ```","faq":null,"created_at":"2025-04-12T12:51:14+00:00","updated_at":"2025-07-07T05:29:14+00:00","source_url":"https://model-context-protocol.com/servers/mcp-server-weread","related_articles":[]}