{"id":27852025,"url":"https://github.com/freestylefly/mcp-server-weread","last_synced_at":"2026-08-27T15:44:49.900Z","repository":{"id":288471044,"uuid":"965114376","full_name":"freestylefly/mcp-server-weread","owner":"freestylefly","description":"微信读书MCP","archived":false,"fork":false,"pushed_at":"2025-05-18T04:32:32.000Z","size":3335,"stargazers_count":570,"open_issues_count":10,"forks_count":60,"subscribers_count":2,"default_branch":"master","last_synced_at":"2026-08-13T11:55:06.834Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/freestylefly.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null,"disclosure":null}},"created_at":"2025-04-12T12:51:14.000Z","updated_at":"2026-08-10T14:15:21.000Z","dependencies_parsed_at":"2025-04-18T08:29:11.954Z","dependency_job_id":"3e8ac462-eb3a-4acc-a39a-78a59c52b9eb","html_url":"https://github.com/freestylefly/mcp-server-weread","commit_stats":null,"previous_names":["freestylefly/mcp-server-weread"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/freestylefly/mcp-server-weread","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/freestylefly%2Fmcp-server-weread","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/freestylefly%2Fmcp-server-weread/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/freestylefly%2Fmcp-server-weread/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/freestylefly%2Fmcp-server-weread/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/freestylefly","download_url":"https://codeload.github.com/freestylefly/mcp-server-weread/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/freestylefly%2Fmcp-server-weread/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":36944061,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-08-22T15:14:58.755Z","status":"online","status_checked_at":"2026-08-27T02:00:07.166Z","response_time":96,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-04T03:01:56.790Z","updated_at":"2026-08-27T15:44:48.814Z","avatar_url":"https://github.com/freestylefly.png","language":"JavaScript","funding_links":[],"categories":["📚 Projects (1974 total)","📦 Other","Art \u0026 Culture","JavaScript","Note-Taking and Knowledge Bases","カテゴリ","📱 Social Media \u0026 Content Platforms"],"sub_categories":["MCP Servers","How to Submit","📝 \u003ca name=\"content--media\"\u003e\u003c/a\u003eコンテンツ・メディア"],"readme":"\u003cp align=\"center\"\u003e\u003cimg src= \"https://cdn.canghecode.com/blog/%E5%BE%AE%E4%BF%A1%E8%AF%BB%E4%B9%A6MCP%20bac.png\" alt=\"MaxKB\" width=\"300\" /\u003e\u003c/p\u003e\n\u003ch3 align=\"center\"\u003e一个为微信读书提供 MCP 服务的工具\u003c/h3\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://opensource.org/license/MIT\"\u003e\u003cimg src=\"https://img.shields.io/github/license/freestylefly/mcp-server-weread?color=rgb(25%2C%20121%2C%20255)\" alt=\"The MIT License\"\u003e\u003c/a\u003e\n  \u003ca href=\"\"\u003e\u003cimg src=\"https://img.shields.io/github/forks/freestylefly/mcp-server-weread?color=green\" alt=\"Forks\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://canghecode.com/\"\u003e\u003cimg src=\"https://img.shields.io/badge/介绍-%E5%AE%98%E7%BD%91-green\" alt=\"Official\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/laigeoffer/pmhub\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/freestylefly/mcp-server-weread?style=flat-square\u0026color=rgb(25%2C%20121%2C%20255)\" alt=\"Stars\"\u003e\u003c/a\u003e    \n  \u003ca href=\"https://mp.weixin.qq.com/s/NQslbUBgWIBMyvTIa3PfYQ\"\u003e\u003cimg src=\"https://img.shields.io/badge/WeReadMCP-教程-blue\" alt=\"Experience\"\u003e\u003c/a\u003e  \n\u003c/p\u003e\n\n\u003chr/\u003e\n\n微信读书 MCP Server 是一个为微信读书提供 MCP（Model Context Protocol）服务的工具，支持将微信读书的书籍、笔记和划线数据提供给支持MCP的大语言模型客户端，如Cursor、Claude Desktop。\n\n## 功能特点\n\n- 从微信读书获取书架信息\n- 搜索书架中的图书\n- 获取图书的笔记和划线\n- 获取图书的热门书评\n- 支持按章节组织笔记和划线\n- 与支持MCP协议的LLM客户端无缝集成\n\n## 主要工具\n\n1. **get_bookshelf** - 获取用户书架上所有书籍\n   - 返回书籍基本信息，包括书名、作者、译者和分类等\n\n2. **search_books** - 通过关键词检索用户书架上的书籍\n   - 支持模糊匹配和精确匹配\n   - 可选是否包含详细信息\n   - 可设置最大结果数量\n\n3. **get_book_notes_and_highlights** - 获取指定书籍的所有划线和笔记\n   - 支持按章节组织结果\n   - 支持筛选划线样式\n   - 返回结构化的数据以便于LLM理解\n\n4. **get_book_best_reviews** - 获取指定书籍的热门书评\n   - 支持设置返回数量\n   - 支持分页浏览\n   - 包含评分、点赞数和评论者信息\n\n## 安装与使用\n\n### 先决条件\n\n- Node.js 16.x 或更高版本\n- 微信读书账号和有效的Cookie\n\n### 安装教程\n\n详见：\n- [用微信读书MCP在Cursor中构建私人图书馆，太哇塞了！](https://mp.weixin.qq.com/s/NQslbUBgWIBMyvTIa3PfYQ)\n- [Weread MCP Server 使用指南](https://chenge.ink/article/post20250505)\n\n### 与Claude Desktop集成\n\n有多种方式可以与Claude Desktop集成：\n\n#### 方式一：通过 npx 使用（最简单，推荐）\n1. 打开Claude Desktop\n2. 进入设置 -\u003e MCP配置\n3. 添加工具，使用以下JSON配置：\n   ```json\n   {\n     \"mcpServers\": {\n       \"mcp-server-weread\": {\n         \"command\": \"npx\",\n         \"args\": [\"-y\", \"mcp-server-weread\"],\n         \"env\": {\n           // 方式1：使用Cookie Cloud（推荐）\n           \"CC_URL\": \"https://cc.chenge.ink\",  // Cookie Cloud的URL\n           \"CC_ID\": \"您的ID\",                   // Cookie Cloud的ID\n           \"CC_PASSWORD\": \"您的密码\"            // Cookie Cloud的密码\n           \n           // 或方式2：直接提供Cookie\n           // \"WEREAD_COOKIE\": \"您的微信读书Cookie\"\n         }\n       }\n     }\n   }\n   ```\n\n#### 方式二：全局安装后使用\n\n1. 全局安装包：\n   ```bash\n   npm install -g mcp-server-weread\n   ```\n\n2. 在Claude配置中使用：\n   ```json\n   {\n     \"mcpServers\": {\n       \"mcp-server-weread\": {\n         \"command\": \"mcp-server-weread\",\n         \"env\": {\n           // 同上方式配置环境变量\n         }\n       }\n     }\n   }\n   ```\n\n\u003e 提示：直接在Claude配置中提供环境变量的方式更加方便，无需设置.env文件，推荐使用。\n\n## CookieCloud 配置说明\n为了解决 Cookie 频繁过期，需要重新获取并更新环境变量的问题。本项目支持 [CookieCloud](https://github.com/easychen/CookieCloud) 服务来自动同步和更新 Cookie。CookieCloud 是一个开源的跨浏览器 Cookie 同步工具，支持自建服务器。\n\n### 配置步骤：\n安装浏览器插件\nEdge商店：[CookieCloud for Edge](https://microsoftedge.microsoft.com/addons/detail/cookiecloud/bffenpfpjikaeocaihdonmgnjjdpjkeo)\nChrome商店：[CookieCloud for Chrome](https://chromewebstore.google.com/detail/cookiecloud/ffjiejobkoibkjlhjnlgmcnnigeelbdl)\n\n### 配置 CookieCloud 插件\n服务器地址：使用默认服务器 https://cc.chenge.ink 或填入自建服务器地址\n点击 \"自动生成密码\"\n同步域名关键词中填入 \"weread\"\n点击\"保存\" ，然后点击 \"手动同步\"确保配置生效\n[可选] 如果需要插件自动保活，可以在保活中填入 https://weread.qq.com，插件会自动刷新 Cookie\n\n在MCP Json中配置CookieCloud变量：\nCC_URL=你的CookieCloud服务器地址 （或使用我的默认服务器地址 https://cc.chenge.ink ）\nCC_ID=你的CookieCloud用户UUID\nCC_PASSWORD=你的CookieCloud密码\n注意：配置 CookieCloud 后，系统会优先使用 CookieCloud 获取 Cookie，获取失败才会使用 WEREAD_COOKIE 环境变量的值。\n\n## Cookie获取方法\n微信读书的Cookie可以通过以下步骤获取：\n1. 使用Chrome浏览器登录[微信读书网页版](https://weread.qq.com/)\n2. 按F12打开开发者工具，切换到Network标签页\n3. 刷新页面，在请求列表中找到weread.qq.com的请求\n4. 在Headers中找到Cookie字段，复制其完整内容\n5. 将复制的内容添加到MCP Json 或 .env文件的WEREAD_COOKIE变量中\n\n## 使用示例\n以下是一些与LLM对话的示例：\n\n**获取书架信息**\n```\n用户: 帮我查看我的微信读书书架\nLLM: 我将获取您的微信读书书架信息。\n[LLM调用get_bookshelf工具]\n我从您的微信读书书架获取到了208本书籍。以下是部分书籍：\n1. 《隐藏的自我》- 大卫·伊格曼\n2. 《思考，快与慢》- 丹尼尔·卡尼曼\n3. 《人类简史》- 尤瓦尔·赫拉利\n...\n```\n\n**搜索特定书籍**\n```\n用户: 帮我找关于心理学的书\nLLM: 我将搜索您书架上与心理学相关的书籍。\n[LLM调用search_books工具，参数为keyword=\"心理学\"]\n在您的书架上，我找到了3本与心理学相关的书籍：\n1. 《思考，快与慢》- 丹尼尔·卡尼曼（进度：75%）\n2. 《乌合之众》- 古斯塔夫·勒庞（进度：50%）\n3. 《心理学与生活》- 理查德·格里格（进度：30%）\n您想了解哪一本书的更多信息？\n```\n\n**获取笔记和划线**\n```\n用户: 帮我整理《思考，快与慢》这本书的笔记\nLLM: 我将获取《思考，快与慢》的笔记和划线。\n[LLM调用search_books工具，找到书籍ID]\n[LLM调用get_book_notes_and_highlights工具]\n以下是您在《思考，快与慢》中的笔记和划线（按章节组织）：\n\n第一章：系统1和系统2\n- 划线：「系统1的运行是无意识且快速的，不怎么费脑力，没有感觉，完全处于自主控制状态。」\n- 您的笔记：「系统1负责直觉和快速判断，系统2负责缓慢的理性思考。」\n\n第三章：锚定效应\n- 划线：「锚定效应指的是在不确定情境下进行数字估计时，会过度受到事先接触的不相干数字的影响。」\n...\n```\n\n**获取热门书评**\n```\n用户: 这本《原则》有哪些热门书评？\nLLM: 我会为您查找《原则》的热门书评。\n[LLM调用search_books工具，找到书籍ID]\n[LLM调用get_book_best_reviews工具]\n以下是《原则》的热门书评：\n\n1. 评论者\"思考者\"（评分：5星）：\n   \"这是一本关于如何思考的书。达利欧将自己多年的经验总结为可操作的原则，帮助我们做出更好的决策。特别喜欢他关于'痛苦+反思=进步'的观点，非常实用。\"\n   👍 182 | 💬 23\n\n2. 评论者\"投资学习者\"（评分：4星）：\n   \"桥水基金创始人的思想精华，值得反复阅读。书中的工作原则部分对管理者特别有帮助，建议先读生活原则，再读工作原则。\"\n   👍 94 | 💬 12\n...\n```\n\n## 九、友情链接\n\n- [mcp-server-weread](https://github.com/ChenyqThu/mcp-server-weread) ：🚀一个为微信读书提供MCP（Model Context Protocol）服务的工具，支持将微信读书的书籍、笔记和划线数据提供给支持MCP的大语言模型客户端，如Claude Desktop。\n- [CodeCanvas](https://github.com/freestylefly/CodeCanvas) ：📚本代码仓库是作者苍何多年从事一线互联网Java开发的学习历程技术汇总，旨在为大家提供一个清晰详细的学习教程，侧重点更倾向编写Java核心内容。💪🏻\n- [PmHub](https://github.com/laigeoffer/pmhub) ：🔥PmHub 是一套基于 SpringCloud \u0026 LLM 的微服务智能项目管理系统，这个项目旨在帮助小伙伴们快速掌握微服务/分布式项目的架构设计和开发流程，如果想在校招或者社招中拿到一个满意的 offer，PmHub 将是一个非常 nice 的选择。\n\n## 十、鸣谢\n\n此项目 fork 自 ChenyqThu 的[mcp-server-weread](https://github.com/ChenyqThu/mcp-server-weread)项目，做了一些小修改，突然就🔥了，这里也请大家去作者GitHub原项目上star，另外ChenyqThu新的更新我也会做同步，项目也会保持使用教程的更新，感谢大家的喜欢。\n\n## 十一、star 趋势图\n\n[![Star History Chart](https://api.star-history.com/svg?repos=freestylefly/mcp-server-weread\u0026type=Date)](https://star-history.com/#freestylefly/mcp-server-weread\u0026Date)\n\n## 十二、公众号\n\n微信搜 **苍何** 或扫描下方二维码关注苍何的原创公众号，回复 **AI** 即可和 5000+ 好友一同探讨AI，一同学习MCP。\n\n![苍何微信公众号](https://cdn.tobebetterjavaer.com/stutymore/%E6%89%AB%E7%A0%81_%E6%90%9C%E7%B4%A2%E8%81%94%E5%90%88%E4%BC%A0%E6%92%AD%E6%A0%B7%E5%BC%8F-%E6%A0%87%E5%87%86%E8%89%B2%E7%89%88.png)\n\n## 十三、许可证\n\n[MIT License (MIT)](https://opensource.org/licenses/MIT)\u003chr/\u003e\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nCopyright (c) 2025-2026 mcp-server-weread\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffreestylefly%2Fmcp-server-weread","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffreestylefly%2Fmcp-server-weread","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffreestylefly%2Fmcp-server-weread/lists"}