moonlin1213/cove-douban-mcp

Privacy-safe, read-only Douban MCP server for local clients.

About cove-douban-mcp

一个独立、可开源、默认只读的豆瓣 MCP 服务。它把本地 Chrome 中已经可见的豆瓣信息，通过标准 Model Context Protocol 提供给 Claude Code、Codex、桌面客户端、编辑器插件，以及开发者自己的前端或后端。

项目支持 macOS 与 Windows，提供 stdio 和仅限本机回环地址的 Streamable HTTP。它不依赖 Cove 主程序，也不会读取或修改任何 Cove 数据。

本项目与豆瓣无隶属、合作或官方授权关系。请遵守豆瓣条款、当地法律和账号 权限边界，仅访问你本来就有权在浏览器中查看的内容。

- 豆瓣侧永久只读：不标记、不评分、不发影评、不改豆列、不改账号。 - 不索取、不导出、不持久化 Cookie；不复制 Chrome profile。 - 默认只写自己的缓存目录。 - Markdown 导出功能存在，但默认关闭。 - confirmeach 模式下，模型只能发起一次性提案，不能批准自己的提案。 - 本地 HTTP 只能绑定 127.0.0.1、localhost 或 ::1，并强制 Bearer 鉴权和浏览器 Origin 检查。 - 安装前检测同名 OpenCLI adapter；默认绝不覆盖。 - 卸载时仅删除哈希仍与安装包一致的 adapter，用户后来改过的文件会保留。

MCP 工具 能力 ------ doubanstatus 本地连接、权限、缓存和同步状态 doubansearch 搜索电影、图书、音乐 doubansubject 查询电影或图书详情 doubanmoviemarks 查询、筛选、分页“看过 / 想看 / 在看” doubanreviews 查询个人影评，可选完整正文 doubanmovieprofile 汇总多个观影状态 doubandoulists 查询豆列、片单、书单 doubandoulistitems 查询一个列表里的条目 doubansync 刷新本地只读缓存 doubanworkingcacheread 分页读取完整服务端结果 doubanexportmarkdown 按本地权限策略导出 Markdown

热门榜单、Top 250 等新能力可以在后续版本以新增工具的方式加入，不会破坏 这 11 个 v0.1.0 工具的合同。

领域层负责标准化、筛选、分页、非缩水合并和不透明结果引用；MCP 层不直接 解析网页。两种传输共用同一个服务容器，因此结果合同一致。

- macOS 13 或更新版本，或受支持的 Windows 10/11； - Python 3.11、3.12 或 3.13； - uv（推荐）或能安装 Python wheel 的工具； - Node.js 22； - OpenCLI 1.8.x； - Chrome，以及可用的 OpenCLI Browser Bridge； - 已在该 Chrome 会话中正常登录豆瓣。

本项目不会自动升级全局 OpenCLI。doctor 会报告版本不匹配并给出处理建议。

打开 Releases， 下载 covedoubanmcp-0.1.0-py3-none-any.whl，然后在下载目录运行：

setup 不会修改任何 MCP 客户端配置。它会输出一份通用配置，用户自行决定 放进哪个客户端。

这是一份标准 MCP stdio 配置，不绑定某个厂商。若客户端使用不同字段名，请 把同一条 command/args 映射进去即可。

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/moonlin1213--cove-douban-mcp.html)

Related MCP servers