AB

andylbrummer/booklife-mcp

API development

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

6 stars 6 forks 품질 62 트렌드 14MIT

One MCP server that connects your library, reading tracker, and bookshelf into a seamless AI-powered reading assistant.

개요

One MCP server that connects your library, reading tracker, and bookshelf into a seamless AI-powered reading assistant. BookLife bridges Hardcover (reading tracker), Libby/OverDrive (library access), and Open Library (metadata) so you can discover books, borrow from the library, track your reading, and get personalized recommendations — all through natural conversation with Claude. For enhanced Claude Code integration with skills and slash commands: See the BookLife plugin in andy-marketplace for details. Search your library catalog, check availability, place holds on ebooks and audiobooks, track loans and due dates — all without opening the Libby app. Manage your reading list, update progress, rate books, and maintain your reading history on Hardcover through natural language. A single to-be-read list that aggregates books from Hardcover (want-to-read), Libby (holds and tags), and manually added physical books. Filter by source, search, and prioritize.

README

원문 README의 일부입니다. 원문 보기.

BookLife MCP

Your reading life, unified. One MCP server that connects your library, reading tracker, and bookshelf into a seamless AI-powered reading assistant.

BookLife bridges Hardcover (reading tracker), Libby/OverDrive (library access), and Open Library (metadata) so you can discover books, borrow from the library, track your reading, and get personalized recommendations — all through natural conversation with Claude.


Quick Start

1. Build

cd booklife-mcp
go build -o booklife ./cmd/booklife

2. Connect Libby

# Get your clone code from Libby app:
# Settings → Copy To Another Device → Sonos Speakers
./booklife libby-connect 

3. Configure

Create 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. Add to Claude Desktop

{
  "mcpServers": {
    "booklife": {
      "command": "/path/to/booklife",
      "args": ["--config", "/path/to/booklife.kdl"],
      "env": {
        "HARDCOVER_API_KEY": "your-key-from-hardcover.app/settings/api"
      }
    }
  }
}

5. Install the Claude Code Plugin (Optional)

For enhanced Claude Code integration with skills and slash commands:

# Add the marketplace
/plugin marketplace add https://github.com/andylbrummer/andy-marketplace

# Install the plugin
/plugin install booklife@andy-marketplace

See the BookLife plugin in andy-marketplace for details.


Features

Library Access (Libby/OverDrive)

Search your library catalog, check availability, place holds on ebooks and audiobooks, track loans and due dates — all without opening the Libby app.

Reading Tracker (Hardcover)

Manage your reading list, update progress, rate books, and maintain your reading history on Hardcover through natural language.

Unified TBR Management

A single to-be-read list that aggregates books from Hardcover (want-to-read), Libby (holds and tags), and manually added physical books. Filter by source, search, and prioritize.

Comprehensive Sync

One-command sync that chains: import Libby loans → mark returned books as “read” in Hardcover → enrich metadata → cache Libby tags. Incremental, with dry-run preview.

Content-Based Recommendations

Enriches your reading history with themes, topics, and mood data from Open Library and Google Books, then finds similar books based on what you’ve enjoyed.

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "booklife": { "command": "/path/to/booklife", "args": ["--config", "/path/to/booklife.kdl"], "env": { "HARDCOVER_API_KEY": "your-key-from-hardcover.app/settings/api" } } } }