Skip to main content
Glama

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.json 1ファイル。約1MB・2,700件規模なので、全件をメモリに載せて部分一致検索する。DB は使わない(部分一致検索と噛み合わないため)

  • 書き込みは ETag を使った条件付き書き込み。別の入口が先に書いていたら最新を読み直して再適用し、黙って上書きしない

  • 巻き戻しは S3 Versioning。古い版は30日で自動削除

  • 業務ロジックは lib/ にだけ置き、MCP(mcp-server.mjs)と Web UI(web.mjs)は入口として呼ぶだけ

入口

書き込み

身元の確認

ローカル stdio(server.mjs)

可

自分のPCにログインできること

ローカル Web UI(web.mjs)

可

127.0.0.1 限定。Host 検査と独自ヘッダで他サイトからの要求を拒否

リモート(Lambda / app.mjs)

不可

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" }

取り込み口

中身

media-log-mcp/service

createService(repo)(検索・候補検索・登録・部分更新・削除)

media-log-mcp/repository

MediaRepository(メモリキャッシュと条件付き保存のやり直し)

media-log-mcp/store

S3Store / FileStore / createStore(uri) / ConflictError

media-log-mcp/schema

種別・状態の語彙と入力スキーマ

media-log-mcp/providers

TMDB / Google Books(キーは環境変数 TMDB_API_KEY / GOOGLE_BOOKS_API_KEY)

取り込む側に書き込みを許すときは、その入口で本人確認をすること(lifelog は Cognito のアクセストークンを検証してから呼ぶ)。exports を変えたらバージョンを上げてタグを打つ。

Related MCP server: LibraryQuietSpot MCP

MCP ツール

type は book / audiobook / movie / anime / drama / variety / game。 status は done(読了・鑑賞済)/ doing(進行中)/ tried(ちょい見・試遊)/ owned(所有・未消化)/ want(これから)/ dropped(途中でやめた)。

ツール

内容

リモート

search_media(keyword, type?, status?, limit=20)

タイトル・作者で検索(「これ読んだ?」判定)。結果の id を編集・削除に使う

○

media_by_creator(creator, type?)

作者別の全件

○

media_stats(type?, topCreators=10)

件数・種別・status・作者・年の集計

○

discover_media(type, query, limit=5)

外部DBから登録候補を探す(登録はしない)

—

add_media(type, externalId?, status?, date?, review?, favoriteRank?, title?, …)

1件登録。externalId を渡すとタイトル・作者・URL・画像を自動で補完。同じ作品があれば登録せず既存を返す

—

update_media(id, patch)

部分更新。null でその項目を削除

—

delete_media(id)

1件削除

—

登録は「discover_media で候補を出す → 1件を選ぶ → add_media に externalId と自分の status / date / review を渡す」の2段階。上位の候補を自動で採用しないのは、同名の別作品や版違いを混ぜないため。

種別

候補検索

必要なキー

book

Google Books

GOOGLE_BOOKS_API_KEY(キー無しの共有枠は枯渇していて使えない)

movie / anime / drama / variety

TMDB

TMDB_API_KEY(v3 キーか v4 トークン)

game / audiobook

なし

title を指定して手入力

書籍は 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):

項目

内容

id

不変の識別子(bk_ mv_ などの接頭辞+10桁)

type / title

必須。通称は "ゼルダの伝説 ティアーズ オブ ザ キングダム (ティアキン)" のように括弧で併記

creator

著者・監督・開発元

status / date / dateLast / times / review / favoriteRank

自分固有の情報。date は初めて読んだ・観た日(ISO 日付か "2010頃"、不明なら省略)、dateLast は最後の日、times は回数(省略は1回。再読・再視聴で増やす)

url / image / externalId

外部の情報。画像は外部 URL をそのまま持つ

source / platform / venue / hours / episodes / progress / purchasedDate

種別固有・取り込み元

createdAt / updatedAt

自動

テスト

npm test

Available Tools

3 tools
media_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

    B3.3/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: retrieving records by creator, aggregating statistics, and searching by keyword. No overlap.

    Naming Consistency5/5

    All names follow a consistent verb_noun snake_case pattern: media_by_creator, media_stats, search_media.

    Tool Count3/5

    3 tools is on the lower end but acceptable for a query-focused server. However, it feels slightly thin for a media tracking service.

    Completeness2/5

    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

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides library visit time recommendations and book recommendations by analyzing real lending data from the Data4Library Open API.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      4
      1
      MIT