mcp-server-weread

Name: mcp-server-weread
Author: freestylefly

byfreestylefly· 2 MCP servers

Stars

566

Forks

How to install mcp-server-weread?

freestylefly/mcp-server-weread

$git clone https://github.com/freestylefly/mcp-server-weread

Installs into the current project.

›Prefer a prompt? Paste this to your agent

Install & use

Install mcp-server-weread by running `git clone https://github.com/freestylefly/mcp-server-weread`, then use it for the current task and follow its documentation at https://github.com/freestylefly/mcp-server-weread.

Files · 1

View on GitHub

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本书籍。以下是

6 picks

Type

Install mcp-server-weread by running `git clone https://github.com/freestylefly/mcp-server-weread`, then use it for the current task and follow its documentation at https://github.com/freestylefly/mcp-server-weread.

mcp-server-weread

How to install mcp-server-weread?

Related

mcp-server-weread

How to install mcp-server-weread?

Related