Skip to content

imai-design/cadence-mcp

Repository files navigation

Cadence MCP

ADHD and bipolar disorder daily-rhythm support — 23 tools, zero dependencies, Python 3.9+.

ADHD・双極性障害のための生活リズム支援 MCP サーバー。Claude に話しかけるだけで使えます。


Warning

これは医療機器でも診断ツールでもありません。 気づきと習慣づくりの補助であって、主治医・薬・専門的な支援の代わりにはなりません。 つらいときは、いつでも下の窓口へ連絡してください。

  • よりそいホットライン: 0120-279-338(24時間・無料)
  • #いのちSOS: 0120-061-338(24時間・無料)
  • 自殺予防いのちの電話: 0120-783-556(毎日 16:00〜21:00・無料)

なぜこれが効くのか

エビデンスに基づく中核だけに絞っています(思いつきの機能は入れていません)。

効く習慣 対象 Cadence の支え方
社会リズム(起床〜就寝の5定点)を一定に保つ 双極 log_social_rhythm / track_rhythm_regularity
睡眠を固定し、短い睡眠の連続を避ける 双極 detect_early_warning(短睡眠の連続に気づく)
早期警告サインと対処を"本人の言葉で"持つ 双極 build_action_plan / detect_early_warning
気分・睡眠の超軽量セルフモニタリング(1日30秒) 両方 log_daily_checkin
大きなタスクを割って「今やる1個」だけ見る ADHD break_down_task / list_today_one_thing
if-then(実行意図)で行動をトリガーに紐づける 両方 create_if_then_plan
時間を見える化(タイムボックス) ADHD start_focus_timer
達成を採点せず可視化し、自分に優しく振り返る 両方 track_achievement
信頼できる人とゆるく共有する 両方 share_summary_with_supporter(同意必須・自動送信なし)
危機のときは専門窓口へ橋渡し route_to_crisis_support(全ツールの安全ハブ)

設計の流れ: 記録 → 気づき → 行動の足場 → 共有 → 安全ハブ。 すべてのツールは、危機を検知したら route_to_crisis_support(窓口)へ合流します。


インストール

依存パッケージはゼロです。Python 3.9 以上があれば動きます。

git clone https://github.com/imai-design/cadence-mcp.git
cd cadence-mcp
python3 run.py   # 動作確認

pip install は不要です。標準ライブラリのみで動作します。


Claude Code への登録

claude mcp add cadence -- python3 /path/to/cadence-mcp/run.py

追加後、Claude Code を開き直すか /mcp で接続を確認してください。

Smithery 経由でのインストール

Smithery に掲載されています。Smithery の UI から検索・インストールするか、 次のコマンドで追加できます。

npx -y @smithery/cli install cadence-mcp --client claude

Vault ミラーの有効化(任意)

環境変数 CADENCE_VAULT_ROOT に Obsidian などの Markdown Vault のパスを指定すると、 気分ログが YYYY-MM-DD.md に追記されます。指定しない場合はローカル DB のみに保存されます。

CADENCE_VAULT_ROOT="/path/to/your/vault" python3 run.py

Claude Code の設定に追加する場合:

{
  "mcpServers": {
    "cadence": {
      "command": "python3",
      "args": ["/path/to/cadence-mcp/run.py"],
      "env": {
        "CADENCE_VAULT_ROOT": "/path/to/your/vault"
      }
    }
  }
}

使い方(Claude にこう言うだけ)

繋いだあとは、自然な言葉で大丈夫です。

  • 「今日の気分3、6時間寝た、薬は飲んだ、で記録して」 → log_daily_checkin
  • 「起きたの8時、寝るの0時でリズム登録して」 → log_social_rhythm
  • 「最近リズムどう?」 → track_rhythm_regularity
  • 「確定申告、でかすぎて動けない。割って」 → break_down_tasklist_today_one_thing
  • 「今やることだけ見せて」 → list_today_one_thing
  • 「終わった、次」 → list_today_one_thing(complete_current)

入力は1日30秒・5項目までが目安です。完璧に記録しなくていいし、休んでも大丈夫です。


ツール一覧(23ツール)

個人向け

ツール 説明
choose_support_mode 相談文から使えそうな道具を安全優先で案内する入口
log_daily_checkin 気分・睡眠・エネルギー・服薬・一言を記録(1日30秒)
log_social_rhythm 起床〜就寝の5定点アンカーを記録(IPSRT準拠)
track_rhythm_regularity リズムの規則性を確認し、乱れを早期検知
build_action_plan 本人の言葉で早期警告サインと対処を作る
detect_early_warning 短睡眠の連続など躁・鬱の初期サインを検出
break_down_task 大きなタスクを小さく割る
list_today_one_thing 今日やる1個だけを表示・完了・次へ
create_if_then_plan if-then形式で行動をトリガーに紐づける
start_focus_timer 5/15/25分のタイムボックスタイマー
track_achievement 達成を採点なしで記録・振り返る
share_summary_with_supporter 信頼できる人と記録をゆるく共有(同意必須・自動送信なし)
route_to_crisis_support 危機のサインを取りこぼさず専門窓口へ橋渡し(全ツールの安全ハブ)
park_idea 夜の思いつきを失わず明日に置いておく(Landing)
reserve_first_step 明日の入口を1つだけ作る(Landing)
start_wind_down 今日を閉じる(Landing)
reenter_stalled 止まった返信・請求・公開へ、完了ではなく再接続から戻る(Re-entry)
low_battery_mode 谷の日の生活維持を最大3択までに減らす(Low Battery)
money_fog お金の不安を3つの事実と今触る1項目へ分ける(Money Fog)

事業所向け(障害福祉)

ツール 説明
support_plan_intake アセスメント登録と個別支援計画の骨子生成(サビ管確認前提)
support_plan_list 起草済み支援計画の一覧
support_plan_export_docx 計画を Word 形式で出力(A4・サビ管承認欄付き)
subsidy_precheck 現況から確認すべき福祉制度カテゴリをチェックリスト表示(受給可否は判定しない)

Cadence Now(ローカル画面)

会話を開く余力がない日でも使える、依存ゼロのローカル PWA です。

python3 run_web.py

http://127.0.0.1:8765 をブラウザで開きます。


HTTP API / 他AI連携

python3 run_api.py

主なエンドポイント:

  • GET /v1/tools — MCP 互換のツール定義
  • GET /v1/tools?format=openai — OpenAI function calling 形式
  • GET /v1/tools?format=anthropic — Anthropic tools 形式
  • POST /v1/tools/{tool_name}/call — ツール実行
  • GET /v1/openapi.json — GPT Actions 等に渡せる OpenAPI

ローカル外へ公開する場合は必ずトークンを設定してください:

CADENCE_API_TOKEN='長いランダム文字列' python3 run_api.py --host 0.0.0.0

テスト

PYTHONPATH=$(pwd) python3 -m unittest discover -s tests -t .

109 テスト全合格を確認しています。


データとプライバシー

  • すべてローカルのみ。第三者送信・広告利用は一切なし。
  • DB: cadence.db(リポジトリ直下・.gitignore で除外済み)
  • 全消去したいとき: rm cadence.db

約束(ツールに焼き込んだ安全ガード)

  • 診断・断定をしない(「あなたは躁です」とは言わない)
  • 薬の量・やめ方・飲み合わせには立ち入らない(主治医へ)
  • ストリーク強要・罰・恥・他者比較・ランキングをしない
  • 通知は最小限。記録を目的化させない
  • 危機のサインは取りこぼさず、専門窓口へ繋ぐ

補助であって、治療の代わりではありません。


公式 Registry への掲載について

server.json は MCP 公式 Registry 向けのメタデータです。PyPI 公開後に有効になります。 それまでは git clone + python3 run.py でご利用ください。


ライセンス

MIT License — Copyright (c) 2026 RYOSEIWORLD

相談窓口の番号・受付時間は、厚生労働省「まもろうよ こころ」と各運営団体の公式情報で確認済みです。

About

Local-first MCP server for ADHD and bipolar daily-living support: check-ins, social rhythm (IPSRT), task breakdown, crisis-safe design. Zero dependencies. Not a medical device.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors