Servidor MCP personal

Un servidor de Protocolo de Contexto Modelo para el seguimiento de la salud y el bienestar personal. Este servidor proporciona herramientas y recursos para el seguimiento de entrenamientos, nutrición y entradas diarias, con análisis asistido por IA mediante la integración con Claude.

Características

Seguimiento del entrenamiento

Registrar ejercicios, series y repeticiones
Realice un seguimiento del esfuerzo percibido y de los sentimientos posteriores al entrenamiento.
Calcular pesos de entrenamiento seguros teniendo en cuenta la rehabilitación
Análisis histórico del entrenamiento
Apoyo para la rehabilitación del hombro
Gestión de carga basada en RPE

Gestión de la nutrición

Registrar comidas y alimentos individuales
Realizar un seguimiento de la ingesta de proteínas y calorías
Monitorizar los niveles de hambre y satisfacción
Objetivos nutricionales diarios y progreso
Seguimiento de la nutrición antes y después del entrenamiento
Análisis del horario de las comidas

Sistema de revistas

Entradas diarias con seguimiento del estado de ánimo y la energía.
Monitoreo de la calidad del sueño y del nivel de estrés
Organización basada en etiquetas
Análisis de tendencias y perspectivas
Análisis de correlación entre entrenamientos, nutrición y bienestar
Reconocimiento de patrones en el estado de ánimo y los niveles de energía

Instalación

Instalación mediante herrería

Para instalar Personal Health Tracker para Claude Desktop automáticamente a través de Smithery :

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

Prerrequisitos

Python 3.10 o superior
gestor de paquetes pip o uv

Usando pip

pip install -e .

Instalación de desarrollo

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

Uso

Servidor básico

Ejecute el servidor con la configuración predeterminada:

personal-mcp run

Modo de desarrollo

Ejecutar con recarga en caliente para desarrollo:

personal-mcp dev

Inspector de MCP

Depurar con el inspector MCP:

personal-mcp inspect

Integración de escritorio de Claude

Instalar en Claude Desktop:

personal-mcp install --claude-desktop

Opciones de configuración

personal-mcp --help

Opciones disponibles:

--name : establece el nombre del servidor (predeterminado: "Asistente personal")
--db-path : especifica la ubicación de la base de datos
--dev : Habilitar el modo de desarrollo
--inspect : Ejecutar con MCP Inspector
-v, --verbose : Habilitar el registro detallado

Herramientas MCP

Herramientas de entrenamiento

# Log a workout
workout = {
    "date": "2024-01-07",
    "exercises": [
        {
            "name": "Bench Press",
            "sets": [
                {"weight": 135, "reps": 10, "rpe": 7}
            ]
        }
    ],
    "perceived_effort": 8
}

# Calculate training weights
params = {
    "exercise": "Bench Press",
    "base_weight": 200,
    "days_since_surgery": 90,
    "recent_pain_level": 2,
    "recent_rpe": 7
}

Herramientas de nutrición

# Log a meal
meal = {
    "meal_type": "lunch",
    "foods": [
        {
            "name": "Chicken Breast",
            "amount": 200,
            "unit": "g",
            "protein": 46,
            "calories": 330
        }
    ],
    "hunger_level": 7,
    "satisfaction_level": 8
}

# Check nutrition targets
targets = await mcp.call_tool("check_nutrition_targets", {"date": "2024-01-07"})

Herramientas de diario

# Create a journal entry
entry = {
    "entry_type": "daily",
    "content": "Great workout today...",
    "mood": 8,
    "energy": 7,
    "sleep_quality": 8,
    "stress_level": 3,
    "tags": ["workout", "recovery"]
}

# Analyze entries
analysis = await mcp.call_tool("analyze_journal_entries", {
    "start_date": "2024-01-01",
    "end_date": "2024-01-07"
})

Desarrollo

Ejecución de pruebas

# Run all tests
pytest

# Run with coverage
pytest --cov=personal_mcp

# Run specific test file
pytest tests/test_database.py

Calidad del código

# Format code
black src/personal_mcp

# Lint code
ruff check src/personal_mcp

# Type checking
mypy src/personal_mcp

Estructura del proyecto

personal-mcp/
├── src/
│   └── personal_mcp/
│       ├── tools/
│       │   ├── workout.py
│       │   ├── nutrition.py
│       │   └── journal.py
│       ├── database.py
│       ├── models.py
│       ├── resources.py
│       ├── prompts.py
│       └── server.py
├── tests/
│   ├── test_database.py
│   ├── test_server.py
│   └── test_cli.py
├── pyproject.toml
└── mcp.json

Contribuyendo

Bifurcar el repositorio
Crear una rama de características
Confirme sus cambios
Empujar hacia la rama
Crear una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Personal MCP Server