TFT-Match-Analyzer

What is TFT-MCP-Server?

TFT-MCP-Server is a Model Context Protocol (MCP) server designed for Teamfight Tactics (TFT). It allows users to access TFT game data, specifically match history and detailed information about individual matches.

How to use TFT-MCP-Server?

To use TFT-MCP-Server, you need to configure it in your Claude Desktop config file. The configuration involves adding a JSON snippet to claude_desktop_config.json (located in ~/Library/Application Support/Claude/ on MacOS or %APPDATA%/Claude/ on Windows). This snippet includes the command to run the server (npx mcp-server-tft) along with your Riot Games API key, game name, and tagline. Once configured, the server will run on stdio and provide access to its tools.

Key Features of TFT-MCP-Server

• Get match history for a summoner: Retrieve a list of past matches for a given summoner. You can specify the number of matches (count) and the starting index for pagination (start).
• Get detailed information about specific TFT matches: Obtain comprehensive data for a particular TFT match by providing its matchId.

Use Cases of TFT-MCP-Server

• Match Analysis: Players can analyze their past performance and strategies by accessing detailed match data.
• Community Tools: Developers can build third-party applications or tools that leverage TFT game data for various purposes, such as stat tracking or replay analysis.
• Personalized Insights: Users can gain insights into their gameplay by reviewing their match history and understanding the specifics of each game.

FAQ from TFT-MCP-Server

• What are the prerequisites for running TFT-MCP-Server? You need Node.js (v14 or higher), npm or yarn, a Riot Games API Key, your Game Name, and your Name Tagline.
• Where can I get a Riot Games API Key? You can obtain a temporary API key for development from the Riot Games Developer Portal. For production use, you need to apply for a permanent personal API key at Riot's Application Portal.
• How do I develop or modify the TFT-MCP-Server? The project is written in TypeScript. You can make changes in the src directory, then run npm run build to compile and npm start with the required parameters to test your changes.
• What tools does the server provide? The server provides tft_match_history to get match history and tft_match_details to get detailed match information.

TFT MCP Server

This is a Model Context Protocol (MCP) server for Team Fight Tactics (TFT) that provides access to TFT game data through various tools.

Features

• Get match history for a summoner
• Get detailed information about specific TFT matches

Prerequisites

• Node.js (v14 or higher)
• npm or yarn
• Riot Games API Key (for accessing TFT data) - Get it from Riot Games Developer Portal
  • Note: For development, you can use a temporary API key that expires in 24 hours
  • For production use, you'll need to apply for a permanent personal API key at Riot's Application Portal
• Your Game Name, accessed from your Riot game console
• Your Name Tagline, accessed from your Riot game console, which is usually followed/shown right after your Game Name. For example: NA1

Usage

1. Configure the MCP server in your Claude Desktop config file:

MacOS

Location: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows

Location: %APPDATA%/Claude/claude_desktop_config.json

Add the following configuration:

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

2. The server will run on stdio and provide the following tools:

tft_match_history

Get TFT match history for the current player.

Parameters:

• count (optional): Number of matches to retrieve. Defaults to 20
• start (optional): Start index for pagination. Defaults to 0

tft_match_details

Get detailed information about a specific TFT match.

Parameters:

• matchId (required): The match ID to get details for

Development

The project is written in TypeScript and uses the Model Context Protocol SDK. To modify the code:

1. Make changes in the src directory
2. Run npm run build to compile
3. Run npm start with the required parameters to test changes

License

MIT