davidmosiah/wellness-nourish

wellness-nourish は何をしますか？

ローカルファースト栄養管理MCP for AIエージェント：食品検索、バーコード/画像認識、食事記録、水分摂取管理、目標設定、Telegram/Hermesワークフロー。

概要

davidmosiah/wellness-nourish は、AIエージェント（Claude Code、Cursor、Codexなど）が簡単に栄養管理機能を統合できるように設計された、ローカルファーストのMCP（Model Context Protocol）スキルです。食品検索、バーコード/画像による食品認識、食事と水分摂取の記録、栄養目標の追跡、そしてTelegramボットやHermesプロトコルを介した外部ワークフローとの連携をサポートします。

主な機能

• 食品検索: テキストまたはバーコード/画像を使って栄養情報を検索します。
• 食事記録: 食事、スナック、水分摂取を記録・管理します。
• 目標設定: カロリー、タンパク質、脂質、炭水化物、水分の目標を設定・追跡します。
• ワークフロー統合: TelegramボットとHermesプロトコルを介して、外部システムとの自動化されたワークフローを作成します。
• ローカルファースト: すべてのデータはエージェントのファイルシステムにローカル保存され、プライバシーとオフライン対応を実現します。

対応プラットフォーム

• Claude Code
• Cursor
• Codex
• MCP互換のAIエージェント

使用方法

MCPサーバーの設定

MCPサーバーを設定するには、使用するAIエージェントの設定ファイルに以下の設定を追加します：

{
  "mcpServers": {
    "wellness-nourish": {
      "command": "go",
      "args": ["run", "main.go"],
      "env": {
        "TELEGRAM_BOT_TOKEN": "your-telegram-bot-token-here",
        "HERMES_WEBHOOK_URL": "https://your-hermes-webhook-url",
        "DATA_DIR": "./data"
      }
    }
  }
}

利用可能なツール

• search_food: 食品名またはバーコードで食品を検索します。
• log_meal: 食事またはスナックを記録します。
• log_water: 水分摂取量を記録します。
• set_goal: 栄養目標を設定します。
• get_progress: その日の進捗状況を取得します。
• analyze_image: 画像から食品を認識します（オプションの機能）。
• send_telegram: Telegramボットを介して通知を送信します。
• trigger_hermes: Hermesプロトコルのワークフローを開始します。

カスタマイズと拡張

このスキルはカスタマイズ可能です。Goコードを編集することで、任意の食品データベースや外部APIと統合できます。main.go ファイル内の FoodDatabase インターフェースを実装することで、カスタムデータソースを追加できます。

技術スタック

• 言語: Go
• プロトコル: MCP (Model Context Protocol)
• データストレージ: ファイルシステム（JSONファイル）
• 外部連携: Telegram Bot API、Hermesプロトコル

ライセンス

MIT