BookLife MCP
你的阅读生活，统一。 一个MCP服务器，将您的图书馆、阅读跟踪器和书架连接成一个无缝的人工智能阅读助手。
BookLife桥梁 精装本 （阅读跟踪器）， 利比/超速驾驶 （图书馆访问），以及 开放图书馆 （元数据），这样你就可以通过与克劳德的自然对话来发现书籍、从图书馆借阅、跟踪阅读情况并获得个性化推荐。
______________________________________________________________________
快速开始
1.建造
cd booklife-mcp
go build -o booklife ./cmd/booklife2.连接利比
# Get your clone code from Libby app:
# Settings → Copy To Another Device → Sonos Speakers
./booklife libby-connect 3.配置
创建 booklife.kdl:
server {
name "booklife"
version "0.1.0"
transport "stdio"
}
providers {
hardcover enabled=true {
api-key env="HARDCOVER_API_KEY"
endpoint "https://api.hardcover.app/v1/graphql"
}
libby enabled=true {
notifications {
hold-available true
due-soon-days 3
}
}
open-library enabled=true {
endpoint "https://openlibrary.org"
covers-endpoint "https://covers.openlibrary.org"
}
}4.添加到克劳德桌面
{
"mcpServers": {
"booklife": {
"command": "/path/to/booklife",
"args": ["--config", "/path/to/booklife.kdl"],
"env": {
"HARDCOVER_API_KEY": "your-key-from-hardcover.app/settings/api"
}
}
}
}5.安装克劳德代码插件（可选）
为了增强Claude Code与技能和斜线命令的集成：
# Add the marketplace
/plugin marketplace add https://github.com/andylbrummer/andy-marketplace
# Install the plugin
/plugin install booklife@andy-marketplace请参阅 andy marketplace中的BookLife插件 了解详情。
______________________________________________________________________
特性
图书馆通道（利比/奥弗驱动器）
搜索你的图书馆目录，检查可用性，搁置电子书和有声读物，跟踪借阅和到期日期——所有这些都不需要打开Libby应用程序。
阅读跟踪器（精装）
通过自然语言在精装本上管理您的阅读清单、更新进度、给书籍评分并维护您的阅读历史。
统一TBR管理
一个单独的待读列表，汇总了精装（想读）、利比（持有和标记）和手动添加的实体书中的书籍。按来源、搜索和优先级过滤。
全面同步
一个命令同步链接：导入Libby贷款→ 马克把精装书归为“已读”→ 丰富元数据→ 缓存Libby标签。增量，带有模拟运行预览。
基于内容的推荐
通过Open Library和Google Books的主题、话题和情绪数据丰富您的阅读历史，然后根据您喜欢的内容找到类似的书籍。
阅读个人资料和分析
自动分析你的阅读模式：格式偏好、热门流派、最喜欢的作者、阅读节奏、连载和完成率。
渐进式发现
内建 info 该工具具有工作流指南、类别浏览和详细的工具帮助。不要想知道有什么可用的，只要问就行了。
______________________________________________________________________
工具一览
| 类别 | 工具 | 目的 |
|---|---|---|
| 精装本 | 3 | 图书馆管理、状态更新、图书跟踪 |
| 莉比 | 6 | 目录搜索、贷款、持有、标签同步 |
| 待读 | 6 | 所有来源的统一阅读列表 |
| 统一 | 2 | 跨提供商搜索和访问建议 |
| 历史 | 4 | 时间线导入、本地存储、统计 |
| 富集 | 2 | 具有进度跟踪功能的后台元数据作业 |
| 同步 | 1 | 与渐进式披露普遍同步 |
| 个人资料 | 1 | 阅读偏好和模式 |
| 建议 | 1 | 基于内容的书籍相似性 |
| 信息 | 1 | 渐进式发现和工作流程指南 |
______________________________________________________________________
建筑
┌──────────────────────────────────────────┐
│ Claude / AI Assistant │
└────────────────────┬─────────────────────┘
│ MCP (stdio)
┌────────────────────▼─────────────────────┐
│ BookLife MCP Server │
│ │
│ ┌─────────┐ ┌─────────┐ ┌───────────┐ │
│ │Hardcover│ │ Libby │ │OpenLibrary│ │
│ │ GraphQL │ │ API │ │ REST API │ │
│ └─────────┘ └─────────┘ └───────────┘ │
│ │
│ ┌──────────────────────────────────┐ │
│ │ Local SQLite Store │ │
│ │ History · TBR · Enrichment │ │
│ └──────────────────────────────────┘ │
└──────────────────────────────────────────┘______________________________________________________________________
文档
完整文档可在 ****:
- 入门指南 --安装和配置
- 工具参考 --所有27个带有参数和示例的工具
- 工作流 --常见任务的分步指南
- 配置 --KDL配置文件参考
- Claude代码插件 --技能和命令通过安迪市场
______________________________________________________________________
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
HARDCOVER_API_KEY | 是的 | 从精装设置中获取 |
BOOKLIFE_DATA_DIR | 否 | 数据目录（默认： ~/.local/share/booklife) |
BOOKLIFE_LOG_LEVEL | 没有 | debug / info / warn / error |
Libby身份验证是通过 booklife libby-connect 命令（不需要环境变量）。
______________________________________________________________________
CLI命令
booklife serve --config booklife.kdl # Start MCP server
booklife libby-connect # Connect Libby account
booklife sync [--dry-run] [--limit N] # Sync returned books to Hardcover
booklife import-timeline # Import Libby timeline JSON
booklife version # Show version______________________________________________________________________
发展
# Build
cd booklife-mcp && go build -o booklife ./cmd/booklife
# Run tests
go test ./...
# Vet
go vet ./...______________________________________________________________________
许可证
个人项目——根据需要进行调整，以适应自己的阅读管理。