Health Reminder MCP

🚀 健康提醒 MCP システム

このシステムは、Model Context Protocol (MCP) に基づく健康提醒システムです。定時でシステム通知を表示し、あなたに体を動かすよう促し、健康を守ります。

🚀 クイックスタート

1. 依存関係のインストール

npm install

2. プロジェクトのコンパイル

npm run build

3. 実行方法

方法1：Clientを実行（推奨）

Clientは自動的にServerに接続し、対話型コンソールを提供します。

npm run client

方法2：ServerとClientをそれぞれ実行

ターミナル1 - Serverを起動:

npm run server

ターミナル2 - Clientを起動:

npm run client

4. 開発モード

# Serverを起動（開発モード）
npm run dev:server

# Clientを起動（開発モード）
npm run dev:client

✨ 主な機能

• 🔔 定時提醒: 指定した時間（デフォルトでは30分）ごとにシステム通知が表示されます。
• ⚙️ カスタム設定: 提醒間隔、メッセージ内容、通知タイトル、通知音をカスタマイズできます。
• 📊 状態監視: 提醒の実行状態と設定情報をリアルタイムで確認できます。
• 🎯 即時提醒: 手動で即時提醒をトリガーできます。
• 🖥️ クロスプラットフォーム: Windows、macOS、Linuxのシステム通知をサポートします。
• 🔌 MCPアーキテクチャ: 完全なClient - Serverアーキテクチャで、統合と拡張が容易です。

📦 インストール

プロジェクト構造

health-reminder-mcp/
├── src/
│   ├── server/
│   │   └── index.ts          # MCP Server 実装
│   └── client/
│       └── index.ts          # MCP Client 実装
├── package.json              # プロジェクト設定
├── tsconfig.json             # TypeScript 設定
└── README.md                 # 説明ドキュメント

💻 使用例

基本的な使用法

例1：デフォルト設定を使用（30分に1回提醒）

1. npm run client を実行します。
2. オプション 1 を選択します。
3. システムは30分ごとに提醒通知を表示します。

例2：カスタム設定（1時間に1回提醒、カスタムメッセージ）

1. npm run client を実行します。
2. オプション 2 を選択します。
3. 間隔時間を入力します：60
4. タイトルを入力します：休息時間
5. メッセージを入力します：已经工作一小时了，该休息一下啦！
6. 通知音を選択します：y

例3：即時通知をテストする

1. npm run client を実行します。
2. オプション 5 を選択します。
3. システムは即座に通知を表示します。

高度な使用法

対話型コンソール

Clientを起動すると、以下のメニューが表示されます。

╔════════════════════════════════════╗
║     健康提醒 MCP Client コンソール     ║
╠════════════════════════════════════╣
║  1. 健康提醒を開始（デフォルト30分）     ║
║  2. 健康提醒を開始（カスタム設定）     ║
║  3. 健康提醒を停止                   ║
║  4. 現在の状態を確認                   ║
║  5. 即時提醒を送信                   ║
║  6. 利用可能なツールを確認                   ║
║  0. プログラムを終了                       ║
╚════════════════════════════════════╝

利用可能なツール（MCP Tools）

MCP Serverは以下のツールを提供します。

1. start_reminder

健康提醒タイマーを起動します。 パラメータ：

• interval (number): 提醒間隔時間（分）、デフォルトは30
• message (string): 提醒メッセージ内容
• title (string): 通知タイトル、デフォルトは"健康提醒"
• sound (boolean): 通知音を再生するかどうか、デフォルトは true

2. stop_reminder

健康提醒タイマーを停止します。

3. get_status

現在の健康提醒の状態と設定を取得します。

4. send_immediate_reminder

即時に健康提醒通知を送信します（タイマーに影響を与えません）。 パラメータ：

• message (string): 提醒メッセージ内容
• title (string): 通知タイトル
• sound (boolean): 通知音を再生するかどうか

📚 ドキュメント

デプロイ方法

• デプロイ方法ガイド - 異なるデプロイ方法の違いを理解します。
• npmへの公開 - 📦 おすすめ！chrome-devtools-mcp のようにあなたのMCP Serverを共有しましょう。
• サーバーデプロイ - クラウドサーバーへのデプロイ（参考用、本プロジェクトでの使用はおすすめしません）

使用と設定

• Cursor設定ガイド - CursorでMCPを使用する方法
• 設定説明 - 詳細な設定オプション
• APIドキュメント - MCPツールのインターフェースドキュメント
• 使用チュートリアル - 完全な使用チュートリアル

⚙️ 技術詳細

カスタムデフォルト設定

以下の3つの方法でデフォルトの提醒時間とメッセージをカスタマイズできます。

1. 設定ファイル（推奨）

プロジェクトのルートディレクトリの config.json を編集します。

{
  "reminder": {
    "interval": 45,
    "message": "已经 45 分钟了，该休息了！",
    "title": "工作提醒",
    "sound": true
  }
}

2. 環境変数

set REMINDER_INTERVAL=60
set REMINDER_MESSAGE=该休息了！
npm run server

3. 呼び出し時のパラメータ

Cursorで：健康提醒を開始、45分に1回

設定の優先順位：呼び出しパラメータ > 環境変数 > 設定ファイル > 組み込みデフォルト値 詳細な設定説明は、設定ガイド | 設定例 を参照してください。

技術スタック

• TypeScript: 型安全なJavaScriptのスーパーセット
• Node.js: JavaScriptのランタイム環境
• @modelcontextprotocol/sdk: MCPの公式SDK
• node-notifier: クロスプラットフォームのシステム通知ライブラリ

設定説明

デフォルト設定

{
  interval: 30,           // 30分
  message: "该起身活动一下了！久坐对健康不利，建议站起来走动走动。",
  title: "健康提醒",
  sound: true            // 通知音を有効にする
}

カスタム設定

以下の方法で設定をカスタマイズできます。

1. 対話型メニューを使用する：オプション2を選択し、指示に従って設定を入力します。
2. MCPツールを呼び出す：start_reminder ツールを使用し、パラメータを渡します。

システム通知のサポート

• Windows 10/11: ネイティブの通知センターを使用します。
• macOS: ネイティブの通知センターを使用します。
• Linux: libnotifyを使用します（インストールが必要です）。

Linuxでの通知サポートのインストール

# Ubuntu/Debian
sudo apt-get install libnotify-bin

# Fedora
sudo dnf install libnotify

# Arch Linux
sudo pacman -S libnotify

🤝 他のアプリケーションへの統合

MCPプロトコルを使用しているため、この健康提醒システムをMCPをサポートする任意のアプリケーションに簡単に統合できます。

1. ServerをMCP設定ファイルに登録します。
2. 任意のMCP Clientを使用して接続します。
3. 提供されているツールを呼び出します。

他の人と共有する

他の人にあなたの健康提醒システムを使用してもらいたい場合は、npmへの公開ガイド を参照してください。

📄 ライセンス

MIT License

🙏 謝辞

• Model Context Protocol
• node-notifier

💪 健康アドバイス

• 30分ごとに5 - 10分間体を動かすことをおすすめします。
• 簡単なストレッチ運動をすることができます。
• 窓の外を見て目を休めましょう。
• 適量の水分を摂り、体の水分バランスを保ちましょう。
• 良い姿勢を保ち、長時間の低頭を避けましょう。

ご利用いただき、健康でいられますように！ 🌟