Tft MCP

🚀 TFT MCP Server

A Model Context Protocol (MCP) server that provides access to game data for "Team Fight Tactics (TFT)", fetching data through various tools.

🚀 Quick Start

This is a Model Context Protocol (MCP) server that offers access to game data for "Team Fight Tactics (TFT)". It retrieves data using multiple tools.

✨ Features

• Retrieve a player's match history.
• Obtain detailed information about specific TFC 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 Portal.
  • Note: You can use a temporary API Key valid for 24 hours during development.
  • For production, you need to apply for a permanent personal API Key. Visit Riot's application portal.
• Your game name, which can be obtained from your Riot Games console.
• Your name tag, which can be obtained from your Riot Games console and is usually displayed after the player's game name. For example: NA1

💻 Usage Examples

Basic Usage

1. Configure the MCP server in your 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 TFC match history. Parameters:

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

tft_match_details

Obtain detailed information about a specific TFC 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 compile.
3. Run npm start with the required parameters to test the changes.

📄 License

MIT