bookmeter-mcp
This server lets you search and analyze a personal media ledger (books, audiobooks, movies, anime, drama, variety, games) in read-only fashion.
Search by keyword (
search_media): look up records by title or creator to check "have I read/watched/played this?" — optionally filter bytypeand cap results withlimit(default 20).List by creator (
media_by_creator): get every record by a given author/director/developer, optionally restricted to onetype.View statistics (
media_stats): totals, breakdown by type, count of records with reviews, top N creators (default 10), and per-year counts — optionally scoped to a singletype.
Note: this schema exposes only read tools (no add/update/delete, no external-DB discovery), matching the read-only remote deployment.
Provides tools to search books by keyword or author, and aggregate reading statistics (total books, top authors, books per year) from a Bookmeter reading log.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@bookmeter-mcp show my reading stats"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
media-log-mcp
自分が触れてきたメディア(本・映画・アニメ・ドラマ・ゲームなど)の個人台帳です。Claude との会話(MCP)とローカルの Web UI から、同じデータを検索・登録・編集できます。
旧リポジトリ名は
bookmeter-mcpです。v0.4.0 で参照専用から書き込み可能な台帳へ移行しました。
構成
Claude Code / Desktop ──stdio──┐
ローカル Web UI (127.0.0.1) ────┼── lib/service.mjs ── S3: media.json(正本・Versioning)
claude.ai / モバイル ──HTTPS──┘ (全入口で共通)
└─ リモート版は読み取り専用正本は S3 の
media.json1ファイル。約1MB・2,700件規模なので、全件をメモリに載せて部分一致検索する。DB は使わない(部分一致検索と噛み合わないため)書き込みは ETag を使った条件付き書き込み。別の入口が先に書いていたら最新を読み直して再適用し、黙って上書きしない
巻き戻しは S3 Versioning。古い版は30日で自動削除
業務ロジックは
lib/にだけ置き、MCP(mcp-server.mjs)と Web UI(web.mjs)は入口として呼ぶだけ
入口 | 書き込み | 身元の確認 |
ローカル stdio( | 可 | 自分のPCにログインできること |
ローカル Web UI( | 可 | 127.0.0.1 限定。Host 検査と独自ヘッダで他サイトからの要求を拒否 |
リモート(Lambda / | 不可 | IP制限+URL秘匿のみ。本人確認にならないため書き込みツールを登録せず、IAM でも S3 の読み取りしか許可しない |
ほかのリポジトリから使う
lib/ は package.json の exports で公開している。lifelog の投稿 Lambda(スマホから作品を登録・状態を変える)は、これを github 依存で取り込んで同じ media.json に書く。書き込みの規則(スキーマ・重複判定・ETag の条件付き書き込み)はここにだけ置き、取り込む側で書き直さない。
"dependencies": { "media-log-mcp": "github:pyonta0215/media-log-mcp#v0.4.1" }取り込み口 | 中身 |
|
|
|
|
|
|
| 種別・状態の語彙と入力スキーマ |
| TMDB / Google Books(キーは環境変数 |
取り込む側に書き込みを許すときは、その入口で本人確認をすること(lifelog は Cognito のアクセストークンを検証してから呼ぶ)。exports を変えたらバージョンを上げてタグを打つ。
Related MCP server: LibraryQuietSpot MCP
MCP ツール
type は book / audiobook / movie / anime / drama / variety / game。
status は done(読了・鑑賞済)/ doing(進行中)/ tried(ちょい見・試遊)/ owned(所有・未消化)/ want(これから)/ dropped(途中でやめた)。
ツール | 内容 | リモート |
| タイトル・作者で検索(「これ読んだ?」判定)。結果の | ○ |
| 作者別の全件 | ○ |
| 件数・種別・status・作者・年の集計 | ○ |
| 外部DBから登録候補を探す(登録はしない) | — |
| 1件登録。 | — |
| 部分更新。 | — |
| 1件削除 | — |
登録は「discover_media で候補を出す → 1件を選ぶ → add_media に externalId と自分の status / date / review を渡す」の2段階。上位の候補を自動で採用しないのは、同名の別作品や版違いを混ぜないため。
種別 | 候補検索 | 必要なキー |
book | Google Books |
|
movie / anime / drama / variety | TMDB |
|
game / audiobook | なし |
|
書籍は ISBN を isbn:978… として持ち、既存の Amazon ASIN(amazon:asin:… = ISBN-10)と同じ本として重複判定する。
ローカルで使う
npm install設定はリポジトリの外の ~/.config/media-log-mcp/env に置く(API キーを誤ってコミット・Lambda へ同梱しないため)。MEDIA_LOG_ENV で場所を変えられる。
MEDIA_STORE=s3://<バケット名>/media.json # sam deploy の出力 MediaStore
AWS_REGION=ap-northeast-1
GOOGLE_BOOKS_API_KEY=... # 任意
TMDB_API_KEY=... # 任意S3 へのアクセスには AWS CLI と同じ認証情報(~/.aws)を使う。
Claude Code / Desktop(stdio)
{
"mcpServers": {
"media-log": { "command": "node", "args": ["/絶対パス/media-log-mcp/server.mjs"] }
}
}stdio 版は書き込みツールも有効。読み取り専用にしたいときは "env": { "MEDIA_LOG_READONLY": "1" }。
Web UI
npm run web # → http://127.0.0.1:4319一覧・絞り込み(種別 / 状態 / 画像なし / 感想なし)・並べ替え・編集・削除・候補からの登録ができる。
リモート(AWS Lambda + Function URL)
claude.ai(Web)やモバイルアプリから検索するための読み取り専用版。
Lambda + Function URL(認証なし)/ Node.js 22.x(arm64)、Streamable HTTP(stateless)
防御は2段: 送信元 IP を Anthropic の outbound レンジ
160.79.104.0/21に限定し、パスを推測困難なランダム文字列にする(MCP_PATH)台帳は S3 から読む。warm な Lambda はメモリ上の台帳を使い回し、リクエストごとに ETag で変更の有無だけ確認する(変更が無ければ 304 で本文は転送されない)
費用: Lambda・CloudFront は常時無料枠内。S3 は12ヶ月無料枠を過ぎると従量だが月 $0.01 程度
デプロイ
openssl rand -hex 16 # 初回のみ: 秘匿パスを生成
npm run deploy # = scripts/build-lambda.sh && sam deploy初回は sam deploy --guided で McpPath=/mcp/<生成した文字列>・AllowedCidr=160.79.104.0/21 を渡す(値は samconfig.toml に保存され、このファイルは .gitignore 済み)。
scripts/build-lambda.shは Lambda に必要なファイルだけをdist/に集める。SAM CLI は.samignoreを読まないため、リポジトリ直下をCodeUriにすると.git/やsamconfig.tomlまでパッケージに入る。
main に入ると GitHub Actions(.github/workflows/deploy.yml)が本番に反映する。npm run deploy は緊急用に残す。AWS へは OIDC で一時クレデンシャルを取り、Secrets は使わない(秘匿パスと AllowedCidr は現在のスタックの値を引き継ぐ)。初回だけ infra/github-deploy.yaml(ロール)を作り、GitHub の Environment production(main のみ)に Variables を登録する。手順は infra/github-deploy.yaml の冒頭と scripts/deploy-ci.sh を参照。
デプロイ後、出力の FunctionUrl の末尾に秘匿パスを付けたものが MCP エンドポイント。claude.ai の Settings > Connectors > Add custom connector に登録する(OAuth 不要)。
データ
旧形式(種別ごとの JSON 8ファイル)は v0.4.0 で S3 の単一台帳へ移行し、リポジトリからは削除した。移行はコミット 9aa7ecc の JSON から再現できる(同じ入力なら ID も含めて同一の出力になる):
mkdir -p /tmp/legacy && git archive 9aa7ecc -- '*.json' ':!package*.json' | tar -x -C /tmp/legacy
node scripts/migrate.mjs --from /tmp/legacy --out ./media.json --at 2026-09-25T00:00:00.000Zレコードの主な項目(lib/schema.mjs):
項目 | 内容 |
| 不変の識別子( |
| 必須。通称は |
| 著者・監督・開発元 |
| 自分固有の情報。 |
| 外部の情報。画像は外部 URL をそのまま持つ |
| 種別固有・取り込み元 |
| 自動 |
テスト
npm testAvailable Tools
3 toolsmedia_by_creator作者別メディア一覧B
指定した作者(著者・監督・開発元など)のメディア記録を全件返す。type未指定なら全種別を対象にする
Inputs: creator (required), type.
media_statsメディア統計C
メディア記録の総件数・種別内訳・感想を書いた数・作者別トップN・年別件数を集計する。type指定でその種別のみ集計
Inputs: type, topCreators.
search_mediaメディア記録検索A
タイトル・作者のキーワードでメディア記録(本・映画・アニメ・ゲーム)を検索する(「これ読んだ/観た/やった?」判定用)。type未指定なら全種別を横断検索
Inputs: keyword (required), type, limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: retrieving records by creator, aggregating statistics, and searching by keyword. No overlap.
All names follow a consistent verb_noun snake_case pattern: media_by_creator, media_stats, search_media.
3 tools is on the lower end but acceptable for a query-focused server. However, it feels slightly thin for a media tracking service.
Missing essential tools for adding, updating, or deleting media records, and no tool to retrieve a single record by ID. The surface is read-only, which is a significant gap.
Maintenance
Related MCP Connectors
Search books and authors, fetch editions, browse subjects, and resolve cover images.
Manage your Readlink book library: add books, track reading, rate, notes, highlights, shelves.
Your own book library and reading journal: TBR, statuses, ratings, collections, goals and journal.
Search Chinese books with Douban ratings, AI book guides and curated toplists. Free, no API key.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables natural language book searches using the Google Books API to retrieve detailed metadata including titles, authors, publishers, and ISBNs. Supports both Japanese and English queries with configurable result counts.-
- AlicenseNot gradedqualityDmaintenanceProvides library visit time recommendations and book recommendations by analyzing real lending data from the Data4Library Open API.MIT
- AlicenseNot gradedqualityBmaintenanceEnables managing a personal bookshelf (CRUD, reading status, tags) and searching/importing Douban book metadata through MCP tools for AI clients like Claude and Cursor.54,355 npmMIT
- AlicenseAqualityBmaintenanceEnables searching the Kakao Daum Book Search API by title, author, publisher, or ISBN, retrieving detailed bibliographic and pricing metadata, and exporting results to xlsx, csv, json, or sqlite through MCP or CLI.41MIT