TFT

🚀 TFT MCP Server

This is a Model Context Protocol (MCP) server that provides access to Teamfight Tactics (TFT) game data.

🚀 Quick Start

This MCP server offers access to TFT game data. To get started, follow the steps in the "Usage" section below.

✨ Features

• Retrieve a summoner's match history.
• Obtain detailed information about specific TFT matches.

📦 Installation

Prerequisites

• Node.js (v14 or higher)
• npm or yarn
• Riot Games API Key (for accessing TFT data) - Obtain it from the Riot Games Developer Console.
  • Note: For development, you can use a temporary API key that expires within 24 hours.
  • For production use, you need to apply for a permanent personal API key. Visit Riot's application portal.
• Your in - game name, which can be obtained from your Riot Games console.
• Your tag line, which can be obtained from your Riot Games console and is usually displayed after the game name. For example: NA1

💻 Usage Examples

Basic Usage

1. Configure the MCP server in the Claude Desktop configuration 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 standard input and output and provide the following tools:

tft_match_history

Retrieve the current player's TFT match history. Parameters:

• count (optional): The number of matches to retrieve. Default is 20.
• start (optional): The starting index for pagination. Default is 0.

tft_match_details

Obtain detailed information about a specific TFT match. Parameters:

• matchId (required): The ID of the match for which to obtain detailed information.

🔧 Technical Details

This 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 build the project.
3. Run npm start with the required parameters to test the changes.

📄 License

This project is licensed under the MIT License.