Skip to main content
Glama
piyo-mcp

piyo-mcp

by sinyo-matu

piyo-mcp

Cloudflare Workers 上の、ぴよログ Data Feed 向け 読み取り専用 MCP サーバーです。Claude Desktop / ChatGPT などから授乳・睡眠・おむつの記録を分析できます。

このリポジトリは 自分でセルフホストする ためのものです。他人の育児記録を集める SaaS ではありません。

注意

  • 乳児の健康記録を LLM に渡します。同意と、ぴよログの利用規約を確認してください。

  • パスワードを知っている人は、保存済みの全記録を読めます。フィード自体は直近最大28日です。

  • サンプルデータや実名を Issue / PR / README に貼らないでください。

  • ぴよログは第三者サービスです。本プロジェクトは非公式です。

Related MCP server: whoop-ai-mcp

できること

MCP エンドポイント: https://<your-worker>.workers.dev/mcp

ツール

内容

get_today_records

今日(JST)の全記録 JSON

get_latest_status

最新の授乳・睡眠・おむつ・体重

get_feeding_records

指定日の食事・授乳

get_all_records

保存済みの全件(分析用。28日を過ぎた記録も含む)

search / fetch

記録の検索と取得

母乳の ml は記録があるときだけ使い、授乳時間から推定しません。

ぴよログのフィードは最大で過去28日分です。取得のたびに、その範囲より前の記録を Worker の KV に月ごとに残します。導入前にフィードから落ちた記録は復元できません。フィードの範囲内の追加・修正・削除は次の取得で反映します。範囲外になったあとの修正・削除は分かりません。

認証は OAuth 2.1(PKCE S256、Dynamic Client Registration)。ChatGPT のツール一覧スキャンは Accept: application/json のみでも tools/list が通ります。Claude コネクタは未認証 /mcp に HTTP 401 と WWW-Authenticate を返します。

セットアップ

必要なもの: Node.js 22+、Cloudflare アカウント、ぴよログ Data Feed の URL。

git clone <this-repo>
cd piyo-mcp
npm install
cp .dev.vars.example .dev.vars

.dev.vars を自分の値に書き換えます。

AUTH_PASSWORD=        # 認証用のパスワード
COOKIE_ENCRYPTION_KEY=  # openssl rand -hex 32
PIYOLOG_FEED_URL=       # ぴよログ Data Feed の URL
CHILD_NAME=Baby         # ツール説明に出す呼び名。実名は任意
AUTH_TTL_SECONDS=15552000  # 再認証までの秒。未設定なら半年(180日)

KV を作り、wrangler.jsonc の OAUTH_KV.id を自分の ID に差し替えます。メンテナの本番 ID が残っているので、フォークしたら必ず置き換えてください。

npx wrangler kv namespace create OAUTH_KV
npm run dev

本番:

npx wrangler secret put AUTH_PASSWORD
npx wrangler secret put COOKIE_ENCRYPTION_KEY
npx wrangler secret put PIYOLOG_FEED_URL
npx wrangler secret put CHILD_NAME
npx wrangler deploy

接続 URL は https://<name>.<account>.workers.dev/mcp です。Claude Desktop のコネクタ、または ChatGPT のカスタム MCP / プラグインから追加し、パスワードで許可します。

GitHub Actions でのデプロイ

main への push で type-check のあと、GitHub のリポジトリシークレットを Cloudflare Worker secrets に載せてデプロイします。再認証までの秒数 AUTH_TTL_SECONDS は秘密ではないので、wrangler.jsonc の vars にデフォルト(180日)を置き、GitHub の Actions variable で上書きできます。

リポジトリの Settings → Secrets and variables → Actions に次を追加してください。

名前

用途

CLOUDFLARE_API_TOKEN

Workers デプロイ用。ダッシュボードの「Edit Cloudflare Workers」テンプレート

CLOUDFLARE_ACCOUNT_ID

ダッシュボード右サイドバーの Account ID

AUTH_PASSWORD

認証パスワード

COOKIE_ENCRYPTION_KEY

OAuth 用署名鍵

PIYOLOG_FEED_URL

ぴよログ Data Feed の URL

CHILD_NAME

ツール説明の呼び名

AUTH_TTL_SECONDS

再認証までの秒(Actions variable。未設定なら 15552000 = 180日)

gh secret set CLOUDFLARE_API_TOKEN
gh secret set CLOUDFLARE_ACCOUNT_ID
gh secret set AUTH_PASSWORD
gh secret set COOKIE_ENCRYPTION_KEY
gh secret set PIYOLOG_FEED_URL
gh secret set CHILD_NAME
# 任意。未設定なら wrangler.jsonc の 180日
# gh variable set AUTH_TTL_SECONDS --body 15552000

未設定のまま main に push すると、空の値で本番シークレットを上書きしないようデプロイ前に失敗します。ローカルの wrangler dev はこれまでどおり .dev.vars を読みます。

開発

npm run type-check
npm run dev          # http://127.0.0.1:8787

wrangler types で worker-configuration.d.ts を更新できます。

セキュリティ

詳しくは SECURITY.md を見てください。脆弱性は Issue に書かず、メンテナへ非公開で連絡してください。

ライセンス

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables Claude Desktop to query and analyze diabetes data from Omnipod 5 and Glooko through natural language, providing clinical audit and triage insights such as time in range, trends, and bolus analysis.
      12
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables Claude, Codex, and GitHub Copilot users to query read-only WHOOP recovery, sleep, HRV, strain, workouts, and personal health analytics through natural language. It provides baselines, trends, readiness insights, and local dashboard views without modifying the user's WHOOP account.
      14 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables Claude, Codex, and GitHub Copilot to ask natural-language questions about read-only WHOOP recovery, sleep, HRV, strain, workouts, personal baselines, trends, sleep debt, weekly reviews, and HYROX/triathlon tracking.
      14 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables users to ask natural-language questions about their WHOOP recovery, sleep, HRV, strain, and workout history through assistants such as Claude Desktop, Claude Code, Codex, and GitHub Copilot. Provides read-only access to personal baselines, trends, sleep debt, and weekly health summaries, plus HYROX and triathlon-specific race analytics.
      14 npm
      MIT