mcp -weread

该 MCP 服务器提供对微信读书数据的模型上下文服务，主要能力包括获取书架信息、按关键词搜索书籍、获取书籍的笔记与划线（可按章节组织并支持筛选样式）、以及获取书籍的热门书评，所有输出均可被支持 MCP 协议的大语言模型客户端直接消费。通过 Claude Desktop 等工具集成时，配置一个 MCP 服务条目，并将服务命名为 mcp-server-weread。您可以通过 npx 快速启动，或在全局安装包后进行本地调用。启动后，LLM 将使用这些工具来查询您的微信读书数据，并将结果以结构化的形式返回给您。

常用工具包括：get_bookshelf（获取书架内书籍的基本信息）、search_books（基于关键词检索书架内书籍，支持模糊/精确匹配、可选详信息与最大结果数）、get_book_notes_and_highlights（获取指定书籍的划线与笔记，支持按章节组织和样式筛选）、get_book_best_reviews（获取指定书籍的热门书评，支持分页和返回数量设置）。要使用这些工具，在 LLM 内部对相应工具发起调用请求，系统将返回结构化数据，便于后续对话和分析。

先决条件：

• Node.js 16.x 或更高版本
• 微信读书账号与可用的 Cookie（或通过 CookieCloud 进行自动管理）

安装步骤：

1. 确认 Node.js 已安装，版本为 16.x 及以上。
2. 通过 npm 或 npx 运行 MCP 服务器：
   • 使用 npx 启动（推荐，最简方式）： npx -y mcp-server-weread
   • 如果你愿意全局安装，请执行： npm install -g mcp-server-weread mcp-server-weread
3. 配置环境变量（CookieCloud 优先，无法获取时再回退到 WEREAD_COOKIE）：
   • 在 Claude/Desktop 端工具配置中，填入如下环境变量： CC_URL=你的 CookieCloud 服务器地址（如 https://cc.chenge.ink） CC_ID=你的 CookieCloud 用户 UUID CC_PASSWORD=你的 CookieCloud 密码 WEREAD_COOKIE=若不使用 CookieCloud，请提供微信读书 Cookie
4. 启动后，按照文档中的 JSON 配置在客户端进行 MCP 服务注册： { "mcpServers": { "mcp-server-weread": { "command": "npx", "args": ["-y", "mcp-server-weread"], "env": { "CC_URL": "https://cc.chenge.ink", "CC_ID": "您的ID", "CC_PASSWORD": "您的密码", "WEREAD_COOKIE": "您的微信读书Cookie" } } } } 注意：若使用 CookieCloud，系统会优先使用 CC_URL、CC_ID、CC_PASSWORD 来获取 Cookie，只有获取失败时才回退使用 WEREAD_COOKIE。

• 确保微信读书的账户 Cookie 有效且未过期，若遇到 Cookie 失效，请通过 CookieCloud 自动刷新流程进行更新。- 在集成 Claude Desktop 时，尽量使用 npx 启动的方式（方式一），以减少本地环境配置的复杂度。- 如对书架信息、笔记、划线、热门书评的输出有特定结构需求，可在请求参数中明确筛选条件（如按章节、返回字段等）。- 某些网络环境下，启动过程可能需要代理设置，请在环境变量中配置 HTTP(S)_PROXY。- MCP 服务返回的数据为结构化文本，便于 LLM 进行逐步对话与推理，请在对话中明确希望查看的书名或书籍 ID。