health-mcp

health.ojimpo.com（Cultural Health Dashboard）の健康・文化活動データを Claude から会話で扱えるようにする読み取り専用 MCP サーバーです。

背景・動機

health-ojimpo は、音楽・読書・運動・SNS などの日常の文化的活動を外部サービスから自動収集し、個人の基準値に対するスコアとして可視化することで、メンタルヘルスの変調を早期に察知するダッシュボードです。

ダッシュボードは「眺める」には良いのですが、「先月と比べて音楽が減ってるのはなぜ？」「この1年で読書が多かった月は？」のような問いかけにはAIとの対話のほうが向いています。そこでダッシュボードのデータをMCPツールとして公開し、claude.ai / Claude Code のどちらからでも自然言語で健康データを分析できるようにしました。

同じ構成の自作MCPサーバー otp-mcp（乗換案内）・cosense-mcp（Cosense）に続く3つ目で、足場（stdio/HTTP両対応のトランスポート層）はそれらから流用しています。

設計思想

• 読み取り専用: データの取り込みや設定変更は載せない。MCP経由での誤操作リスクをゼロにし、認証なし運用（後述）を許容できるようにする

• バックエンドに寄生しない: health-ojimpo の REST API を叩くだけの薄いクライアント。スコアリングロジックはバックエンド側の単一実装のまま

• 出力サイズを制御: スコア履歴のカテゴリ列はオプトイン、生データは件数上限 + 週/月集計モードで、LLMのコンテキストを溢れさせない

• stdio と Streamable HTTP の両対応: ローカルの Claude Code からは stdio、claude.ai からは Cloudflare Tunnel 経由の HTTP で同じサーバーに接続する

ツール

構成

claude.ai ──HTTPS──> Cloudflare Tunnel ──> localhost:4102 ──> health-mcp(Docker)
Claude Code ──stdio──> node build/index.js                        │ HTTP (docker network)
                                              health-ojimpo backend (FastAPI) <──┘

• health-mcp コンテナは health-ojimpo の Docker ネットワーク（health-ojimpo_default）に相乗りし、http://backend:8000 でAPIに到達します

• stdio モード（Claude Code）はホストの http://localhost:8400（backendのlocalhost公開ポート）を使います

セットアップ

ビルド

npm install
npm run build

CLI（動作確認用）

export HEALTH_API_BASE_URL=http://localhost:8400
node build/index.js status
node build/index.js history 3m music,sleep
node build/index.js recent 5
node build/index.js sources
node build/index.js records 2026-06-01 2026-06-30 lastfm '' week

Docker（HTTP モード）

docker compose up -d --build
curl http://localhost:4102/health   # {"status":"ok"}

※ health-ojimpo のスタックが先に起動している必要があります（externalネットワーク参照のため）。

Claude Code への登録（stdio）

claude mcp add --scope user health \
  --env HEALTH_API_BASE_URL=http://localhost:8400 \
  -- node /path/to/health-mcp/build/index.js

claude.ai への登録（リモートコネクタ）

1. Cloudflare Tunnel の ingress に health-mcp.example.com → http://localhost:4102 を追加

2. claude.ai → Settings → Connectors → Add custom connector → URL に https://health-mcp.example.com/mcp を指定

環境変数

将来の展望

• 主観フィードバック（気分の記録）ツール — バックエンド側にエンドポイントができたら書き込み系として追加検討

• スコア変動の要因分解ツール（どのソースがスコアを下げているかの内訳）