Diet / Meal Log MCP Server
食事ログを管理するMCP (Model Context Protocol) サーバーです。
機能
add_meal: 食事ログを追加get_daily_summary: 指定日の食事ログと合計カロリーを取得get_week_summary: 指定週の食事ログと合計カロリーを取得
必要な環境
Python 3.11以上
uv (推奨) または pip
セットアップ
1. uvを使う方法（推奨）
uvは高速なPythonパッケージマネージャーです。
# uvのインストール
curl -LsSf https://astral.sh/uv/install.sh | sh
# 仮想環境の作成（Python 3.11を自動ダウンロード）
uv venv --python 3.11
# 仮想環境の有効化
source .venv/bin/activate
# 依存関係のインストール
uv pip install -r requirements.txt
2. pipを使う方法
# Python 3.11以上がインストールされていることを確認
python --version
# 仮想環境の作成
python -m venv .venv
# 仮想環境の有効化
source .venv/bin/activate
# 依存関係のインストール
pip install -r requirements.txt
使い方
このサーバーは2つのモードで動作します：
モード1: ローカルモード（stdio）
Claude Desktopなどのローカルクライアント向け。
# 仮想環境を有効化
source .venv/bin/activate
# stdioモードで起動（デフォルト）
python server.py
Claude Desktopでの設定例
~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"diet-mcp": {
"command": "/Users/soichiro.inatani/src/diet-mcp/.venv/bin/python",
"args": ["/Users/soichiro.inatani/src/diet-mcp/server.py"],
"env": {}
}
}
}
モード2: ネットワークモード（SSE）
別デバイスからアクセスする場合。
# 仮想環境を有効化
source .venv/bin/activate
# SSEモードで起動（ネットワーク経由）
python server.py --sse
サーバーは http://0.0.0.0:8000 で起動します。
他のデバイスからの接続
サーバーのIPアドレスを確認
ifconfig | grep "inet " | grep -v 127.0.0.1
# 例: inet 192.168.0.184
クライアント側の設定
Claude Desktopの設定ファイル ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"diet-mcp-remote": {
"url": "http://192.168.0.184:8000/sse",
"transport": "sse"
}
}
}
注意事項：
サーバーとクライアントが同じネットワーク内にある必要があります
ファイアウォールでポート8000を開放してください
インターネット経由でアクセスする場合は、適切なセキュリティ対策（認証、HTTPS化など）が必要です
データの保存
食事ログは ~/diet-mcp-meals.json に保存されます。
開発
プロジェクト構成
diet-mcp/
├── server.py # MCPサーバー本体
├── meals.json # 食事ログデータ（自動生成）
├── requirements.txt # Python依存関係
├── .python-version # Pythonバージョン指定
├── .venv/ # 仮想環境（git管理外）
└── README.md # このファイル
チーム開発での環境共有
.python-versionでPythonバージョンを固定requirements.txtで依存関係を固定.venv/はgit管理から除外（.gitignoreに追加）
# 新しいメンバーがリポジトリをクローンしたら
git clone <repository-url>
cd diet-mcp
# 環境構築
uv venv --python 3.11
source .venv/bin/activate
uv pip install -r requirements.txt
# サーバー起動
python server.py
ライセンス
このプロジェクトは自由に使用できます。
This server cannot be installed