Ultrahuman

Obtenha métricas de saúde e condicionamento físico, como frequência cardíaca, sono e passos, da API Ultrahuman.

GitHub
20
Experimente este MCPPatrocinado

Documentação

Ultrahuman MCP Server

Um servidor Model Context Protocol (MCP) para buscar métricas de saúde e condicionamento físico da API Ultrahuman. Construído com TypeScript e projetado para uso em produção.

🚀 Início Rápido

  1. Clone o repositório
  2. Instale as dependências: 
    bun install
  3. Compile o projeto: 
    bun run build
  4. Configure suas variáveis de ambiente (veja a seção Configuração)
  5. Adicione ao Claude Desktop (veja a seção Uso)

🔑 Primeiros Passos com a API Ultrahuman

Antes de usar este servidor MCP, você precisará obter suas credenciais Ultrahuman. Siga estes passos:

Passo 1: Obtenha seu E-mail Ultrahuman

  1. Abra o aplicativo Ultrahuman no seu dispositivo
  2. Navegue até a aba Perfil na parte inferior da tela
  3. Toque no ícone de configurações (ícone de engrenagem) no canto superior esquerdo
  4. Seu endereço de e-mail será exibido no topo da tela de configurações
  5. Copie este endereço de e-mail - você precisará dele para a configuração

Passo 2: Solicite a Chave de API e o Partner ID

Você deve obter uma chave de API e um Partner ID da Ultrahuman entrando em contato por um destes métodos:

  • E-mail: Envie uma solicitação para support@ultrahuman.com
  • Chat no aplicativo: Use o chat de atendimento ao cliente dentro do aplicativo Ultrahuman

Importante: Certifique-se de incluir seu endereço de e-mail Ultrahuman na solicitação para agilizar o tempo de resposta.

Ao receber sua chave de API e seu Partner ID, mantenha-os seguros e privados.

Passo 3: Configure o Partner ID no Aplicativo

  1. Abra o aplicativo Ultrahuman no seu dispositivo
  2. Navegue até a aba Perfil na parte inferior da tela
  3. Toque no ícone de configurações (ícone de engrenagem) no canto superior esquerdo
  4. Role para baixo para encontrar o campo Partner ID
  5. Insira o código do Partner ID que você recebeu da Ultrahuman

Passo 4: Configure o Servidor MCP

Agora você pode configurar este servidor MCP com suas credenciais:

  1. Defina suas variáveis de ambiente (veja a seção Configuração abaixo)
  2. Compile e execute o servidor
  3. Adicione-o ao Claude Desktop com suas credenciais de API

Tudo pronto para começar a buscar seus dados de saúde!

✨ Principais Recursos

  • Busque métricas abrangentes de saúde da API Ultrahuman
  • Monitoramento de frequência cardíaca, sono, passos, temperatura e VFC
  • Construído com TypeScript para segurança de tipos
  • Bun para testes e desenvolvimento rápidos
  • Biome para linting e formatação
  • Estrutura de projeto limpa e de fácil manutenção

📂 Estrutura do Projeto

ultrahuman-mcp/
├── src/
│   ├── tools/          # MCP tools implementation
│   │   └── ultrahumanMetrics/  # Ultrahuman API integration
│   ├── utils/          # Shared utilities
│   ├── main.ts         # Server entry point
│   └── types.ts        # Shared type definitions
├── scripts/            # Build and utility scripts
├── biome.json          # Linting configuration
├── tsconfig.json       # TypeScript configuration
└── package.json        # Project dependencies

⚙️ Configuração

Este servidor requer variáveis de ambiente para autenticar com a API Ultrahuman:

  • ULTRAHUMAN_AUTH_TOKEN: Seu token de autorização da API Ultrahuman
  • ULTRAHUMAN_USER_EMAIL: O endereço de e-mail do usuário Ultrahuman cujos dados você deseja buscar

A URL base da API está configurada para https://partner.ultrahuman.com/api/v1.

🔧 Ferramentas Disponíveis

ultrahuman_metrics

Busca métricas de saúde e condicionamento físico da API Ultrahuman para uma data específica. O e-mail do usuário é configurado por meio de variável de ambiente, então você só precisa especificar a data para obter dados abrangentes de saúde.

Parâmetros:

  • date: Data no formato AAAA-MM-DD para buscar métricas (por exemplo, '2025-06-19')

Exemplo de Uso:

{
  "name": "ultrahuman_metrics",
  "arguments": {
    "date": "2025-06-19"
  }
}

📊 Dados de Saúde Disponíveis

A API fornece métricas abrangentes de saúde, incluindo:

  • Frequência Cardíaca: Monitoramento contínuo da frequência cardíaca com carimbos de data/hora
  • Temperatura da Pele: Variações da temperatura corporal ao longo do dia
  • VFC (Variabilidade da Frequência Cardíaca): Medições da variabilidade da frequência cardíaca
  • Passos: Dados de contagem de passos com rastreamento de atividade
  • Dados de Sono: Análise detalhada do sono, incluindo:
    • Estágios do sono (Profundo, Leve, REM, Acordado)
    • Métricas de eficiência e qualidade do sono
    • Frequência cardíaca e VFC durante o sono
    • Variações de temperatura durante o sono
  • Índice de Recuperação: Pontuação geral de recuperação
  • Índice de Movimento: Métricas de atividade e movimento
  • VO2 Máx: Indicador de aptidão cardiovascular

💻 Uso com o Claude Desktop

  1. Compile o projeto:

    bun run build

  2. Adicione à sua configuração do Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

    {
  "mcpServers": {
    "ultrahuman": {
      "command": "node",
      "args": ["/path/to/your/project/dist/main.js"],
      "env": {
        "ULTRAHUMAN_AUTH_TOKEN": "your_token_here",
        "ULTRAHUMAN_USER_EMAIL": "your_email@example.com"
      }
    }
  }
}

🧪 Testes

Você pode testar o servidor executando-o diretamente:

node dist/main.js

O servidor escutará solicitações MCP no stdio e fornecerá a ferramenta ultrahuman_metrics para buscar dados de saúde da API.

🛠️ Desenvolvimento

  • Executar testes: bun test
  • Formatar código: bun run format
  • Verificar código (lint): bun run lint
  • Compilar projeto: bun run build

📜 Gerenciamento de Versão

Este projeto usa standard-version para gerenciamento automatizado de versões. Execute bun run release para criar uma nova versão.

Formato da Mensagem de Commit

  • feat: Novo recurso (incrementa a versão menor)
  • fix: Correção de bug (incrementa a versão de patch)
  • BREAKING CHANGE: Mudança significativa (incrementa a versão principal)

📦 Publicação no npm

  1. Certifique-se de estar conectado ao npm: 
    npm login
  2. Compile o projeto: 
    bun run build
  3. Publique o pacote: 
    npm publish

Instalação a partir do npm (após a publicação)

Adicione à sua configuração do Claude Desktop:

{
  "mcpServers": {
    "ultrahuman": {
      "command": "npx",
      "args": ["-y", "ultrahuman-mcp"],
      "env": {
        "ULTRAHUMAN_AUTH_TOKEN": "your_token_here",
        "ULTRAHUMAN_USER_EMAIL": "your_email@example.com"
      }
    }
  }
}