FragValue MCP Server

Serveur Model Context Protocol (MCP) pour FragValue. Expose les donnees d'analyse CS2 (FV Rating, heatmaps, stats agregees) aux agents IA : Claude Desktop, Cursor, Cline, ChatGPT custom GPTs.

Pourquoi ce projet

Les agents IA deviennent les nouvelles interfaces pour les services en ligne. Au lieu que tu visites fragvalue.com pour voir tes stats, ton agent IA personnel (Claude, Cursor, etc) peut interroger FragValue directement et te presenter les resultats dans son interface.

Ce MCP server est la surface agentique de FragValue. Il permet a n'importe quel agent compatible MCP de :

• Lister les dernieres demos analysees d'un joueur
• Recuperer l'analyse complete d'une demo specifique
• Calculer des stats agregees (FV Rating moyen, tendance, maps preferees)
• Chercher dans les ~17 articles de blog FragValue

Tools exposes (v0.2)

| Tool | Description | Auth requise | |------|-------------|--------------| | list_recent_demos | Liste les N dernieres demos d'un joueur (par FACEIT nickname ou user_id) | Non | | get_demo_analysis | Retourne l'analyse complete d'une demo (FV Rating, scoreboard, statut parsing) | Non | | get_player_stats | Calcule FV Rating moyen, tendance, maps preferees sur N dernieres demos | Non | | search_articles | Cherche dans le blog FragValue par mot-cle | Non | | get_death_events | Liste les morts d'un joueur dans une demo : round, timing, position, killer, weapon, side, headshot | Non | | get_round_breakdown | Breakdown round-by-round : first kill, duree, winner, kills T/CT, et role du joueur cible | Non | | get_player_duels | Matrice de duels : entries (win rate par side), trades in/out, HS rate, weapon usage, top opponents | Non |

Read-only. Les tools write (analyser une nouvelle demo, modifier une analyse) arriveront en v0.3 avec OAuth flow.

Note v0.2 : les 3 nouveaux tools (get_death_events, get_round_breakdown, get_player_duels) necessitent une demo parsee avec parser FragValue v6.7+. Les demos plus anciennes retournent un message d'erreur explicite.

Installation

Installation locale (npm)

npm install -g fragvalue-mcp

Configuration Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows) :

{
  "mcpServers": {
    "fragvalue": {
      "command": "npx",
      "args": ["-y", "fragvalue-mcp"],
      "env": {
        "FRAGVALUE_SUPABASE_URL": "https://xmyruycvvkmcwysfygcq.supabase.co",
        "FRAGVALUE_SUPABASE_ANON_KEY": "ta_clef_anon_ici"
      }
    }
  }
}

Recupere ta clef anon Supabase sur https://fragvalue.com/account.html (section API access).

Configuration Cursor

Edit ~/.cursor/mcp.json :

{
  "mcpServers": {
    "fragvalue": {
      "command": "npx",
      "args": ["-y", "fragvalue-mcp"],
      "env": {
        "FRAGVALUE_SUPABASE_URL": "https://xmyruycvvkmcwysfygcq.supabase.co",
        "FRAGVALUE_SUPABASE_ANON_KEY": "ta_clef_anon_ici"
      }
    }
  }
}

Configuration Cline (VS Code extension)

Edit le fichier de config Cline via la palette de commandes : Cline: Edit MCP Settings.

{
  "mcpServers": {
    "fragvalue": {
      "command": "npx",
      "args": ["-y", "fragvalue-mcp"],
      "env": {
        "FRAGVALUE_SUPABASE_URL": "https://xmyruycvvkmcwysfygcq.supabase.co",
        "FRAGVALUE_SUPABASE_ANON_KEY": "ta_clef_anon_ici"
      }
    }
  }
}

Exemples d'usage

Une fois configure, demande a ton agent :

Lister tes dernieres demos

"Montre-moi les 10 dernieres demos de NiKo sur FragValue"

Comparer 2 joueurs

"Compare le FV Rating moyen de ZywOo et donk sur leurs 20 dernieres demos"

Detecter une lose streak

"Verifie si Qwhentin est en lose streak (regarde sa tendance sur les 5 derniers matchs)"

Question pedagogique

"Explique-moi le spray pattern AK-47 dans CS2 et donne-moi des sources FragValue"

Coaching cinematique (v0.2)

"Analyse ma derniere demo et dis-moi mes erreurs recurrentes. Mon FACEIT est Qwhentin."

L'agent chaine plusieurs tools :

1. list_recent_demos pour trouver la demo
2. get_death_events pour voir ou tu meurs (timing, side, killer)
3. get_player_duels pour la matrice entries/trades/HS
4. get_round_breakdown pour le contexte tactique des rounds problematiques
5. Synthese : "Tu meurs en first-death sur 4 rounds T-side sur 6, dont 3 dans les 12 premieres secondes mid Cache. Tu over-peeks sans utility. Travaille les smokes mid + ralentis ta premiere prise d'info."

L'agent va automatiquement appeler les bons tools, parser les resultats et te repondre en langage naturel.

Developpement local

# Clone le repo
git clone https://github.com/Ladreuille/fragvalue-mcp
cd fragvalue-mcp

# Install deps
npm install

# Dev mode (TypeScript direct)
npm run dev

# Build production
npm run build

# Run compiled
npm run start

Architecture

• Communication : STDIO (stdin/stdout JSON-RPC), standard MCP.
• Storage : Supabase (queries via @supabase/supabase-js avec anon key).
• Read-only en v0.2 : les tools write necessiteraient un OAuth flow user-specific, planifie pour v0.3.
• Validation input : Zod sur chaque tool pour rejeter les params malformes avant query DB.

Roadmap

• v0.2 : Coaching primitives — get_death_events, get_round_breakdown, get_player_duels (done).
• v0.3 : OAuth flow (l'agent demande l'autorisation user pour les actions write).
• v0.4 : Tool analyze_demo (upload + parse en background, retour async via webhook).
• v0.5 : Tool compare_to_pro (benchmark vs un pro player via stats HLTV).
• v0.6 : Serveur HTTP host (en plus du STDIO local) pour deploiement remote.
• v1.0 : Listing officiel sur la registry MCP Anthropic + Smithery.

Licence

MIT. Utilise FragValue API qui a ses propres CGV : https://fragvalue.com/cgv.html

Support

• Email : [email protected]
• Discord : https://discord.gg/fragvalue (channel #mcp-server)
• Issues : https://github.com/Ladreuille/fragvalue-mcp/issues