TFT MCP Server

TFT MCP Server

Este é um servidor Model Context Protocol (MCP) para Team Fight Tactics (TFT) que fornece acesso aos dados do jogo TFT por meio de várias ferramentas.

Recursos

• Obter histórico de partidas de um invocador
• Obter informações detalhadas sobre partidas específicas de TFT

Pré-requisitos

• Node.js (v14 ou superior)
• npm ou yarn
• Chave de API da Riot Games (para acessar dados do TFT) - Obtenha-a no Portal de Desenvolvedores da Riot
  • Nota: Para desenvolvimento, você pode usar uma chave de API temporária que expira em 24 horas
  • Para uso em produção, você precisará solicitar uma chave de API pessoal permanente no Portal de Aplicações da Riot
• Seu Game Name, acessado pelo seu console de jogo da Riot
• Sua Name Tagline, acessada pelo seu console de jogo da Riot, que geralmente é exibida logo após o seu Game Name. Por exemplo: NA1

Uso

1. Configure o servidor MCP no arquivo de configuração do Claude Desktop:

MacOS

Localização: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows

Localização: %APPDATA%/Claude/claude_desktop_config.json

Adicione a seguinte configuração:

{
  "mcpServers": {
    "tft-mcp": {
      "command": "npx",
      "args": [
        "mcp-server-tft",
        "--apiKey",
        "<YOUR_RIOT_API_KEY>",
        "--gameName",
        "<YOUR_GAME_NAME>",
        "--tagLine",
        "<YOUR_TAG_LINE>"
      ]
    }
  }
}

2. O servidor será executado em stdio e fornecerá as seguintes ferramentas:

tft_match_history

Obter o histórico de partidas de TFT do jogador atual.

Parâmetros:

• count (opcional): Número de partidas a recuperar. Padrão: 20
• start (opcional): Índice inicial para paginação. Padrão: 0

tft_match_details

Obter informações detalhadas sobre uma partida específica de TFT.

Parâmetros:

• matchId (obrigatório): O ID da partida para obter detalhes

Desenvolvimento

O projeto é escrito em TypeScript e usa o SDK do Model Context Protocol. Para modificar o código:

1. Faça alterações no diretório src
2. Execute npm run build para compilar
3. Execute npm start com os parâmetros necessários para testar as alterações

Licença

MIT