convez.ai
MCP ServerIntegração & APIsIntermediário
Ladreuille

FragValue MCP Server

Ladreuille/fragvalue-mcp

Análise de demos CS2 via MCP para agentes IA

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que expõe dados de análise de demos CS2 (FV Rating, heatmaps, estatísticas) para agentes IA como Claude, Cursor e Cline. Permite que IA consulte análises de gameplay, estatísticas agregadas de jogadores e conteúdo do blog FragValue diretamente.

Instalação

$npx convez-ai Ladreuille/fragvalue-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Consultar análises completas de demos de Counter-Strike 2
  • Obter estatísticas agregadas e tendências de performance de jogadores
  • Análise de eventos de morte, breakdowns de rounds e duelos
  • Pesquisar artigos e insights do blog FragValue via agentes IA

Veredito

MCP server bem estruturado para integrar análises de CS2 em workflows de IA. Implementação clara com suporte a múltiplos agentes (Claude, Cursor, Cline), mas nicho específico para comunidade gamer/esports interessada em análise tática.

README

A tradução para o português deste README ainda está na fila.

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)

ToolDescriptionAuth requise
list_recent_demosListe les N dernieres demos d'un joueur (par FACEIT nickname ou user_id)Non
get_demo_analysisRetourne l'analyse complete d'une demo (FV Rating, scoreboard, statut parsing)Non
get_player_statsCalcule FV Rating moyen, tendance, maps preferees sur N dernieres demosNon
search_articlesCherche dans le blog FragValue par mot-cleNon
get_death_eventsListe les morts d'un joueur dans une demo : round, timing, position, killer, weapon, side, headshotNon
get_round_breakdownBreakdown round-by-round : first kill, duree, winner, kills T/CT, et role du joueur cibleNon
get_player_duelsMatrice de duels : entries (win rate par side), trades in/out, HS rate, weapon usage, top opponentsNon

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

Ver o original no GitHub

Bom para

Relacionados