Open Source

Il Tuo Assistente AI, I Tuoi Dati Fitness

arvo-mcp connette Claude Desktop, Cursor e altri client AI direttamente ai tuoi dati di allenamento. Traccia PR, analizza progressi e gestisci il training attraverso conversazione naturale.

Vedi su GitHub
npm install arvo-mcp

Cos'e arvo-mcp?

arvo-mcp e un server Model Context Protocol open source che permette agli assistenti AI come Claude di leggere e scrivere i tuoi dati di allenamento Arvo. Installa, configura la tua API key e inizia a chattare con l'AI dei tuoi workout.

Cos'e il Model Context Protocol?

MCP e un protocollo aperto di Anthropic che standardizza come gli assistenti AI si connettono a dati esterni. Invece di copiare e incollare dati nelle chat, MCP permette all'AI di accedere direttamente alle tue informazioni - in modo sicuro e con il tuo controllo.

Funzionalita

29 Tool Disponibili

Accesso completo a lettura e scrittura per workout, PR, esercizi, split di allenamento, misurazioni corporee e altro.

Comprensione Naturale

Chiedi 'qual e il mio PR di squat?' o 'registra la sessione di oggi' - l'AI capisce il contesto fitness.

Open Source

Codice completamente aperto su GitHub. Ispeziona, modifica, contribuisci. Nessuna scatola nera.

Sicuro per Design

Autenticazione tramite API key, nessuna credenziale memorizzata, revoca accesso in qualsiasi momento.

Client AI Supportati

arvo-mcp funziona con qualsiasi client che supporta il Model Context Protocol:

Claude Desktop
Cursor IDE
Windsurf
Cline
+ any MCP client

Quick Start

1

Installa il pacchetto

npm install -g arvo-mcp
2

Configura Claude Desktop

Aggiungi al file di configurazione di Claude:

{
  "mcpServers": {
    "arvo": {
      "command": "npx",
      "args": ["-y", "arvo-mcp"],
      "env": {
        "ARVO_API_KEY": "your-api-key"
      }
    }
  }
}
3

Inizia a chattare

Apri Claude e chiedi dei tuoi allenamenti:

"Qual e il mio allenamento di oggi?"
"Mostrami i miei PR"
"Registra 3x8 squat a 100kg"
"Come stanno andando i miei progressi questo mese?"

Tool Disponibili

arvo-mcp fornisce 29 tool per gestione completa dei dati fitness:

Lettura

get_workoutsRetrieve workout history
get_workout_by_idGet specific workout details
get_personal_recordsView all-time PRs
get_exercisesList available exercises
get_exercise_historyTrack exercise progress
get_training_splitView current split
get_profileGet user profile data
get_body_measurementsTrack body measurements

Scrittura

log_workoutLog a new workout
log_exerciseLog exercise sets
update_personal_recordUpdate a PR
create_workout_planGenerate workout plan

+ 17 more tools for complete fitness data management

Casi d'Uso

Tracking Conversazionale

Chatta con Claude dei tuoi allenamenti. Chiedi PR, cronologia, progressi - tutto in linguaggio naturale senza aprire l'app.

Logging Veloce

Registra allenamenti mentre lavori. Dillo semplicemente a Claude e aggiorna i tuoi dati senza interrompere il flusso.

Analisi Progressi

Chiedi a Claude di analizzare i tuoi trend, identificare plateau, suggerire aggiustamenti basati sui tuoi dati reali.

Pianificazione Workout

Lascia che Claude generi workout basati sulla tua cronologia, preferenze e obiettivi. L'AI conosce i tuoi dati.

Sicurezza e Privacy

  • Autenticazione tramite chiave API personale
  • Nessuna credenziale memorizzata dall'AI
  • Tutti i dati transitano tramite API sicure Arvo
  • Revoca accesso in qualsiasi momento dalle impostazioni
  • Codice open source - verifica tu stesso

Domande Frequenti

Cos'e il Model Context Protocol (MCP)?

MCP e un protocollo aperto sviluppato da Anthropic che crea un modo standardizzato per gli assistenti AI di interagire con strumenti e fonti dati esterne. Invece di addestrare l'AI su dati statici, MCP permette all'AI di accedere a informazioni in tempo reale dalle tue app. arvo-mcp implementa questo protocollo per i dati fitness.

Come connetto Claude ai miei dati di allenamento?

Installa arvo-mcp tramite npm, aggiungi la tua chiave API Arvo al file di configurazione e aggiungi arvo-mcp alle impostazioni di Claude Desktop o Cursor. L'AI avra automaticamente accesso al tuo storico allenamenti, PR e dati di training.

Quali client AI sono supportati?

arvo-mcp funziona con qualsiasi client compatibile MCP inclusi Claude Desktop (macOS, Windows), Cursor IDE, Windsurf e altri strumenti che implementano il Model Context Protocol. Sempre piu client stanno aggiungendo supporto MCP.

I miei dati fitness sono sicuri?

Si. Tutte le connessioni sono autenticate tramite la tua chiave API personale. L'AI accede ai dati tramite l'API sicura di Arvo - non memorizza mai le tue credenziali. Mantieni il pieno controllo sui dati a cui l'AI puo accedere e puoi revocare l'accesso in qualsiasi momento.

Cosa posso chiedere all'AI sui miei allenamenti?

Puoi fare domande in linguaggio naturale come 'Qual e il mio PR di panca?', 'Mostra lo storico allenamenti di questa settimana', 'Quali esercizi lavorano il petto?', 'Registra 3 serie da 8 ripetizioni a 100kg per squat', o 'Crea un allenamento push'. L'AI comprende il contesto fitness.

L'AI puo modificare i miei dati di allenamento?

Si, con il tuo permesso. arvo-mcp supporta operazioni di lettura e scrittura. L'AI puo registrare allenamenti, aggiornare PR, modificare la tua split di allenamento e tracciare esercizi - tutto tramite conversazione naturale. Le operazioni di scrittura richiedono conferma esplicita.

arvo-mcp e gratuito?

Si, arvo-mcp e completamente gratuito e open source. Hai bisogno di un account Arvo (gratuito o a pagamento) per accedere ai tuoi dati di allenamento. Non ci sono costi aggiuntivi per usare il server MCP.

Qual e la differenza rispetto ai plugin ChatGPT?

MCP e un protocollo local-first - l'AI gira sul tuo computer e si connette direttamente alle fonti dati. Questo significa migliore privacy (nessun dato inviato a terze parti), capacita offline e risposte piu veloci. E anche standardizzato su piu client AI.

Pronto a Connettere il Tuo AI?

Inizia a tracciare i tuoi allenamenti con Claude in meno di 2 minuti.