金大哥 - tft-mcp MCP 详情

article

README

🚀 TFT MCP 服务器

这是一个专为《Team Fight Tactics (TFT)》游戏数据提供访问服务的 Model Context Protocol (MCP) 服务器。它借助多种工具来获取游戏数据，为玩家和开发者提供了便捷的数据访问途径。

🚀 快速开始

要使用这个 TFT MCP 服务器，您需要完成一系列的准备工作，具体步骤如下：

先决条件

Node.js（v14 或更高版本）
npm 或 yarn
Riot Games API Key（用于访问 TFT 数据） - 您可以从 Riot Games 开发者门户获取。
- 注意：开发时可以使用有效期为24小时的临时 API Key。
- 生产环境需要申请永久个人 API Key，请访问 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>"
      ]
    }
  }
}

✨ 主要特性

获取玩家的对战历史：通过服务器，您可以轻松获取当前玩家的 TFC 比赛历史。
获取特定 TFC 比赛的详细信息：能够获取指定 TFC 比赛的详细数据。

📦 安装指南

该项目使用 TypeScript 编写，并且使用 Model Context Protocol SDK。若要对代码进行修改，可按以下步骤操作：

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

💻 使用示例

基础用法

服务器将运行在标准输入输出上，并提供以下工具：

tft_match_history

获取当前玩家的 TFC 比赛历史。参数：

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

tft_match_details

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

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

📄 许可证

本项目采用 MIT 许可证。

tft-mcp