JinDaGe - TFT MCP Details

article

README

🚀 TFT MCP 服务器

这是一个模型上下文协议（MCP）服务器，专为团队策略战斗（TFT）游戏数据提供访问服务。它能让用户轻松获取TFT游戏中的对战历史和比赛详细信息，为玩家和开发者提供了极大的便利。

🚀 快速开始

本服务器为TFT游戏数据访问提供支持，您可以按以下步骤进行配置和使用。

✨ 主要特性

对战历史获取：可获取 summoner 的对战历史。
比赛详情查询：能获取特定 TFT 比赛的详细信息。

📦 安装指南

先决条件

Node.js：版本需为 v14 或更高。
包管理器：npm 或 yarn 均可。
Riot Games API Key：用于访问 TFT 数据，可从Riot Games 开发者控制台获取。
- 注意：开发时，可使用 24 小时内过期的临时 API 密钥。
- 生产用途需要申请永久个人 API 密钥，请访问Riot 的申请门户。
游戏名称：从您的 Riot 游戏控制台获取。
名字标签线：从您的 Riot 游戏控制台获取，通常显示在游戏名称之后，例如：NA1。

💻 使用示例

配置 MCP 服务器

在 Claude Desktop 配置文件中配置 MCP 服务器：

MacOS

配置文件位置：~/Library/Application Support/Claude/claude_desktop_config.json

Windows

配置文件位置：%APPDATA%/Claude/claude_desktop_config.json 添加以下配置：

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

工具使用

tft_match_history

获取当前玩家的 TFT 对战历史。参数：

count（可选）：要检索的比赛数量，默认为 20。
start（可选）：分页起始索引，默认为 0。

tft_match_details

获取特定 TFT 比赛的详细信息。参数：

matchId（必需）：要获取详细信息的比赛 ID。

🔧 技术细节

该项目使用 TypeScript 和模型上下文协议 SDK 编写。若要修改代码，可按以下步骤操作：

在src目录下进行更改。
运行npm run build进行构建。
使用所需的参数运行npm start以测试更改。

📄 许可证

本项目采用 MIT 许可证。

TFT