mcp-server-weread
starsforks
How to install mcp-server-weread?
freestylefly/mcp-server-weread
$git clone https://github.com/freestylefly/mcp-server-weread<hr/>
README.md
| 1 | <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> |
| 2 | <h3 align="center">一个为微信读书提供 MCP 服务的工具</h3> |
| 3 | <p align="center"> |
| 4 | <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> |
| 5 | <a href=""><img src="https://img.shields.io/github/forks/freestylefly/mcp-server-weread?color=green" alt="Forks"></a> |
| 6 | <a href="https://canghecode.com/"><img src="https://img.shields.io/badge/介绍-%E5%AE%98%E7%BD%91-green" alt="Official"></a> |
| 7 | <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> |
| 8 | <a href="https://mp.weixin.qq.com/s/NQslbUBgWIBMyvTIa3PfYQ"><img src="https://img.shields.io/badge/WeReadMCP-教程-blue" alt="Experience"></a> |
| 9 | </p> |
| 10 | |
| 11 | <hr/> |
| 12 | |
| 13 | 微信读书 MCP Server 是一个为微信读书提供 MCP（Model Context Protocol）服务的工具，支持将微信读书的书籍、笔记和划线数据提供给支持MCP的大语言模型客户端，如Cursor、Claude Desktop。 |
| 14 | |
| 15 | ## 功能特点 |
| 16 | |
| 17 | - 从微信读书获取书架信息 |
| 18 | - 搜索书架中的图书 |
| 19 | - 获取图书的笔记和划线 |
| 20 | - 获取图书的热门书评 |
| 21 | - 支持按章节组织笔记和划线 |
| 22 | - 与支持MCP协议的LLM客户端无缝集成 |
| 23 | |
| 24 | ## 主要工具 |
| 25 | |
| 26 | 1. **get_bookshelf** - 获取用户书架上所有书籍 |
| 27 | - 返回书籍基本信息，包括书名、作者、译者和分类等 |
| 28 | |
| 29 | 2. **search_books** - 通过关键词检索用户书架上的书籍 |
| 30 | - 支持模糊匹配和精确匹配 |
| 31 | - 可选是否包含详细信息 |
| 32 | - 可设置最大结果数量 |
| 33 | |
| 34 | 3. **get_book_notes_and_highlights** - 获取指定书籍的所有划线和笔记 |
| 35 | - 支持按章节组织结果 |
| 36 | - 支持筛选划线样式 |
| 37 | - 返回结构化的数据以便于LLM理解 |
| 38 | |
| 39 | 4. **get_book_best_reviews** - 获取指定书籍的热门书评 |
| 40 | - 支持设置返回数量 |
| 41 | - 支持分页浏览 |
| 42 | - 包含评分、点赞数和评论者信息 |
| 43 | |
| 44 | ## 安装与使用 |
| 45 | |
| 46 | ### 先决条件 |
| 47 | |
| 48 | - Node.js 16.x 或更高版本 |
| 49 | - 微信读书账号和有效的Cookie |
| 50 | |
| 51 | ### 安装教程 |
| 52 | |
| 53 | 详见： |
| 54 | - [用微信读书MCP在Cursor中构建私人图书馆，太哇塞了！](https://mp.weixin.qq.com/s/NQslbUBgWIBMyvTIa3PfYQ) |
| 55 | - [Weread MCP Server 使用指南](https://chenge.ink/article/post20250505) |
| 56 | |
| 57 | ### 与Claude Desktop集成 |
| 58 | |
| 59 | 有多种方式可以与Claude Desktop集成： |
| 60 | |
| 61 | #### 方式一：通过 npx 使用（最简单，推荐） |
| 62 | 1. 打开Claude Desktop |
| 63 | 2. 进入设置 -> MCP配置 |
| 64 | 3. 添加工具，使用以下JSON配置： |
| 65 | ```json |
| 66 | { |
| 67 | "mcpServers": { |
| 68 | "mcp-server-weread": { |
| 69 | "command": "npx", |
| 70 | "args": ["-y", "mcp-server-weread"], |
| 71 | "env": { |
| 72 | // 方式1：使用Cookie Cloud（推荐） |
| 73 | "CC_URL": "https://cc.chenge.ink", // Cookie Cloud的URL |
| 74 | "CC_ID": "您的ID", // Cookie Cloud的ID |
| 75 | "CC_PASSWORD": "您的密码" // Cookie Cloud的密码 |
| 76 | |
| 77 | // 或方式2：直接提供Cookie |
| 78 | // "WEREAD_COOKIE": "您的微信读书Cookie" |
| 79 | } |
| 80 | } |
| 81 | } |
| 82 | } |
| 83 | ``` |
| 84 | |
| 85 | #### 方式二：全局安装后使用 |
| 86 | |
| 87 | 1. 全局安装包： |
| 88 | ```bash |
| 89 | npm install -g mcp-server-weread |
| 90 | ``` |
| 91 | |
| 92 | 2. 在Claude配置中使用： |
| 93 | ```json |
| 94 | { |
| 95 | "mcpServers": { |
| 96 | "mcp-server-weread": { |
| 97 | "command": "mcp-server-weread", |
| 98 | "env": { |
| 99 | // 同上方式配置环境变量 |
| 100 | } |
| 101 | } |
| 102 | } |
| 103 | } |
| 104 | ``` |
| 105 | |
| 106 | > 提示：直接在Claude配置中提供环境变量的方式更加方便，无需设置.env文件，推荐使用。 |
| 107 | |
| 108 | ## CookieCloud 配置说明 |
| 109 | 为了解决 Cookie 频繁过期，需要重新获取并更新环境变量的问题。本项目支持 [CookieCloud](https://github.com/easychen/CookieCloud) 服务来自动同步和更新 Cookie。CookieCloud 是一个开源的跨浏览器 Cookie 同步工具，支持自建服务器。 |
| 110 | |
| 111 | ### 配置步骤： |
| 112 | 安装浏览器插件 |
| 113 | Edge商店：[CookieCloud for Edge](https://microsoftedge.microsoft.com/addons/detail/cookiecloud/bffenpfpjikaeocaihdonmgnjjdpjkeo) |
| 114 | Chrome商店：[CookieCloud for Chrome](https://chromewebstore.google.com/detail/cookiecloud/ffjiejobkoibkjlhjnlgmcnnigeelbdl) |
| 115 | |
| 116 | ### 配置 CookieCloud 插件 |
| 117 | 服务器地址：使用默认服务器 https://cc.chenge.ink 或填入自建服务器地址 |
| 118 | 点击 "自动生成密码" |
| 119 | 同步域名关键词中填入 "weread" |
| 120 | 点击"保存" ，然后点击 "手动同步"确保配置生效 |
| 121 | [可选] 如果需要插件自动保活，可以在保活中填入 https://weread.qq.com，插件会自动刷新 Cookie |
| 122 | |
| 123 | 在MCP Json中配置CookieCloud变量： |
| 124 | CC_URL=你的CookieCloud服务器地址 （或使用我的默认服务器地址 https://cc.chenge.ink ） |
| 125 | CC_ID=你的CookieCloud用户UUID |
| 126 | CC_PASSWORD=你的CookieCloud密码 |
| 127 | 注意：配置 CookieCloud 后，系统会优先使用 CookieCloud 获取 Cookie，获取失败才会使用 WEREAD_COOKIE 环境变量的值。 |
| 128 | |
| 129 | ## Cookie获取方法 |
| 130 | 微信读书的Cookie可以通过以下步骤获取： |
| 131 | 1. 使用Chrome浏览器登录[微信读书网页版](https://weread.qq.com/) |
| 132 | 2. 按F12打开开发者工具，切换到Network标签页 |
| 133 | 3. 刷新页面，在请求列表中找到weread.qq.com的请求 |
| 134 | 4. 在Headers中找到Cookie字段，复制其完整内容 |
| 135 | 5. 将复制的内容添加到MCP Json 或 .env文件的WEREAD_COOKIE变量中 |
| 136 | |
| 137 | ## 使用示例 |
| 138 | 以下是一些与LLM对话的示例： |
| 139 | |
| 140 | **获取书架信息** |
| 141 | ``` |
| 142 | 用户: 帮我查看我的微信读书书架 |
| 143 | LLM: 我将获取您的微信读书书架信息。 |
| 144 | [LLM调用get_bookshelf工具] |
| 145 | 我从您的微信读书书架获取到了208本书籍。以下是 |
People who liked this also viewed
6 picksType
- odoo-mcp-proAI connector for Odoo ERP | Connect Claude, ChatGPT, Cursor and other AI tools to Odoo via MCPMCP ServersJul 2026
- omnigentUniversal autonomous agent framework with ReAct loop, multi-provider LLM routing, reasoning graph, and MCP integration, domain-agnostic for building specialized AI agents.MCP ServersFeb 2026
- arxiv-mcp-serverAn MCP server that enables interacting with the arXiv API using natural languageMCP ServersAug 2025
- United States WeatherProvide real-time and forecast weather information for locations in the United States using natural language queries. Access current conditions, multi-day and hourly forecasts, weather alerts, and nearby weather stations without requiring aMCP Serversrecently
- mcp-server-demoDemo of MCP Server in Python using FastMCPMCP ServersAug 2025
- mcp-serverlearn to make some mcp serversMCP ServersMay 2025
