Personal Health Tracker

🚀 Personal MCP Server

A Model Context Protocol (MCP) server for personal health and well - being tracking. This server offers tools and resources to record workouts, nutrition, and daily journal entries, and enables AI - assisted analysis through Claude integration.

🚀 Quick Start

The Personal MCP Server is a powerful tool for personal health and well - being tracking. It provides various features to help you manage your workouts, nutrition, and daily life records.

✨ Features

Workout Tracking

• Record exercises, sets, and reps.
• Track perceived effort and post - workout feelings.
• Calculate safe training weights using rehabilitation considerations.
• Analyze historical workouts.
• Support shoulder rehabilitation.
• Manage loads based on perceived exertion.

Nutrition Management

• Record meals and individual food items.
• Track protein and calorie intake.
• Monitor hunger and satiety levels.
• Track daily nutrition goals and progress.
• Record nutrition intake before and after yoga.
• Analyze post - meal intervals.

Journal System

• Keep daily records with mood and energy tracking.
• Monitor sleep quality and stress levels.
• Organize entries with tags.
• Conduct trend analysis and gain insights.
• Analyze correlations between workouts, nutrition, and well - being.
• Identify patterns in mood and energy levels.

📦 Installation

Install via Smithery

To automatically install Personal Health Tracker for Claude Desktop via Smithery:

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

Prerequisites

• Python 3.10 or higher
• pip or uv package manager

Install with pip

pip install -e .

Development Installation

git clone https://github.com/yourusername/personal-mcp.git
cd personal-mcp
uv pip install -e ".[dev]"

💻 Usage Examples

Basic Server Operation

Run with default settings:

server.py

Interactive Operation

Interact via the command line:

python cli.py

📚 Documentation

Please refer to the official documentation for detailed information.

🔧 Technical Details

Project Structure

personal-mcp/
├── src/
│   └── personal_mcp/
│       ├── tools/
│       │   ├── workout.py           # Workout - related tools
│       │   ├── nutrition.py         # Nutrition - related tools
│       │   └── journal.py           # Journal management tools
│       ├── database.py              # Database processing module
│       ├── models.py                 # Model definition file
│       ├── resources.py             # Resource management module
│       ├── prompts.py               # Prompt template collection
│       └── server.py                # Server main program
├── tests/
│   ├── test_workout.py              # Workout function tests
│   ├── test_nutrition.py            # Nutrition function tests
│   └── test_journal.py              # Journal function tests
├── pyproject.toml                  # Project dependency management file
└── mcp.json                        # MCP configuration file

🤝 Contribution Guide

1. Fork the repository.
2. Create a feature branch.
3. Commit your changes.
4. Push to the branch.
5. Create a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.