Monitoramento de Glicose - MCP

Este é um projeto que utiliza o framework FastMCP para criar um sistema de monitoramento de glicemia, permitindo registrar, analisar e visualizar dados de glicose no sangue.

Visão Geral

O aplicativo permite aos usuários:

• Registrar medições de glicose com notas
• Visualizar registros recentes de glicemia
• Analisar tendências de glicose ao longo do tempo
• Gerar gráficos de níveis de glicose
• Obter estatísticas diárias e análises personalizadas

Requisitos

• Python 3.10 ou superior
• Bibliotecas listadas no arquivo requirements.txt

Instalação

Método 1: Utilizando script de configuração (Recomendado para Unix/Mac)

O projeto inclui um script de configuração que utiliza o gerenciador de pacotes uv para uma instalação mais rápida e eficiente:

1. Clone este repositório
2. Execute o script de instalação:

   chmod +x setup.sh
   ./setup.sh
   

3. Ative o ambiente virtual:

   source .venv/bin/activate
   

Método 2: Instalação manual

1. Clone este repositório
2. Crie e ative um ambiente virtual:

   python -m venv venv
   source venv/bin/activate  # No Windows: venv\Scripts\activate
   

3. Instale as dependências:

   pip install -r requirements.txt
   

Configuração

Crie um arquivo .env na raiz do projeto com as seguintes variáveis (opcionais):

GLUCOSE_API_URL=https://sua-api-glicose.com
GLUCOSE_API_KEY=sua_chave_api

Se não for configurada uma API externa, o sistema utilizará armazenamento local no diretório data/.

Executando o Projeto

Após a instalação e configuração, você pode iniciar o servidor MCP com o seguinte comando:

uv run mcp dev main.py

Isto iniciará o servidor FastMCP em modo de desenvolvimento. Uma vez em execução, você pode acessar o MCP Inspector através do navegador:

http://127.0.0.1:6274/

O MCP Inspector fornece uma interface web onde você pode interagir com o sistema, testar as funcionalidades, visualizar registros de glicose e executar análises.

Uso

Comandos Disponíveis

O sistema oferece vários prompts pré-definidos para analisar dados de glicose:

• Análise da última semana
• Análise das últimas duas semanas
• Análise do último mês
• Análise do impacto das refeições na glicose
• Relatório diário de glicose

Ferramentas Disponíveis

• add_glucose_reading: Adiciona um novo registro de glicose
• analyze_glucose_trends: Analisa tendências de glicose por período
• generate_glucose_chart: Gera gráfico de níveis de glicose

Estrutura do Projeto

• api/glucose_api.py: Implementação da API para gerenciamento de registros de glicose
• glucose_mcp/: Módulo principal do aplicativo
  • prompts.py: Define prompts para o assistente
  • resources.py: Implementa recursos para obtenção de dados
  • tools.py: Ferramentas para registro e análise de dados