🚀 豆瓣MCP服务器
此MCP服务器提供了搜索和交互豆瓣（中国社交网络服务平台）内容的功能，涵盖书籍、电影和小组讨论，能有效满足用户对豆瓣各类信息的查询需求。
🚀 快速开始
入门步骤
- 克隆仓库
- 安装依赖:
npm install - 构建服务器:
npm run build - 启动服务器:
npm start
与桌面应用集成使用
要将此服务器与桌面应用程序集成，请在应用程序的服务器配置中添加以下内容:
{
"mcpServers": {
"douban-mcp": {
"command": "node",
"args": [
"{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
],
"env": {
"COOKIE": "bid=;ck=;dbcl2=;frodotk_db=;" // 从网站获取 Cookie 值
}
}
}
}
✨ 主要特性
- 按书名关键词或 ISBN 搜索书籍
- 查看书籍评论
- 按标题搜索电影
- 查看电影评论
- 在默认浏览器中浏览书籍详情
- 列出带有筛选选项的小组主题
- 查看特定小组主题的详细信息
📦 安装指南
环境搭建
- 克隆仓库
- 安装依赖:
npm install - 构建服务器:
npm run build - 启动服务器:
npm start
💻 使用示例
基础用法
以下是使用各个工具的基本示例：
搜索书籍
# 按关键词搜索书籍
search-book --q "百年孤独"
# 按ISBN搜索书籍
search-book --isbn "9787020049108"
查看书籍评论
list-book-reviews --id "123456"
搜索电影
search-movie --q "泰坦尼克号"
查看电影评论
list-movie-reviews --id "234567"
浏览书籍详情
browse --id "123456"
列出小组主题
# 列出默认小组主题
list-group-topics
# 按标签筛选主题
list-group-topics --tags "文学"
# 按日期筛选主题
list-group-topics --from_date "2024-01-01"
获取小组主题详情
get-group-topic-detail --id "345678"
📚 详细文档
组件
工具
| 工具名称 | 功能 | 输入参数 |
|---|---|---|
| search-book | 从豆瓣搜索书籍信息 | isbn (字符串, 可选): 要获取的书籍 ISBNq (字符串, 可选): 书籍标题的搜索关键词 |
| list-book-reviews | 获取书籍评论自豆瓣 | id (字符串): 豆瓣书籍 ID |
| search-movie | 从豆瓣搜索电影信息 | q (字符串): 电影标题的搜索关键词 |
| list-movie-reviews | 获取电影评论自豆瓣 | id (字符串): 豆瓣电影 ID |
| browse | 在默认浏览器中打开书籍详细页面 | id (字符串): 豆瓣书籍 ID |
| list-group-topics | 列出豆瓣小组的主题 | id (字符串, 可选): 豆瓣小组 ID（默认为 '732764'）tags (字符串[], 可选): 按标签筛选主题from_date (字符串, 可选): 按日期筛选主题（格式: "YYYY-MM-DD"） |
| get-group-topic-detail | 获取特定主题的详细信息 | id (字符串): 豆瓣主题 ID |
🔧 技术细节
开发命令
- 构建:
npm run build - 监视模式:
npm run dev - 启动:
npm start - 测试:
npm test
依赖
- @modelcontextprotocol/sdk: MCP SDK
- dayjs: 日期库
- json2md: JSON 转 Markdown 转换器
- turndown: HTML 转 Markdown 转换器
- zod: TypeScript 先行架构验证
资源
📄 许可证
此项目在 MIT License 下许可。