TFT MCP Server

Name: TFT MCP Server
Author: GeLi2001

本地服务

github.com/GeLi2001游戏娱乐982 周前更新

代码仓库

关于 TFT MCP Server

TFT MCP Server 为 MCP 客户端提供《云顶之弈》游戏数据，可查询召唤师的对局历史及指定对局详情，并使用 Riot Games API 密钥访问数据。

主要功能

01查询召唤师对局历史
02获取指定对局详情
03分页查看对局历史

适用场景

01查看近期 TFT 对局
02按对局 ID 查询详情

MCP 相关

该服务通过 stdio 运行，向 MCP 客户端提供对局历史和详情工具。访问 TFT 数据需要 Riot Games API 密钥。

#tft #mcp #game-data

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "tft": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-tft"
      ]
    }
  }
}

启动命令npx -y mcp-server-tft

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmmcp-server-tftstdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

TFT MCP 服务

这是一个用于 Team Fight Tactics（TFT）的模型上下文协议（MCP）服务，可通过各种工具访问 TFT 游戏数据。

功能

获取召唤师的对局历史
获取特定 TFT 对局的详细信息

前提条件

Node.js（v14 或更高版本）
npm 或 yarn
Riot Games API 密钥（用于访问 TFT 数据）——从 Riot Games Developer Portal 获取
- 注意：开发时可使用有效期为 24 小时的临时 API 密钥
- 用于生产时，需要通过 Riot's Application Portal 申请永久个人 API 密钥
游戏名称，可从 Riot 游戏客户端中查看
名称标签，可从 Riot 游戏客户端中查看，通常紧跟在游戏名称后面或显示在其后。例如：NA1

使用方法

在 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>"
      ]
    }
  }
}

服务将通过 stdio 运行，并提供以下工具：

tft_match_history

获取当前玩家的 TFT 对局历史。

参数：

count（可选）：要获取的对局数量。默认为 20
start（可选）：分页的起始索引。默认为 0

tft_match_details

获取特定 TFT 对局的详细信息。

参数：

matchId（必填）：要获取详情的对局 ID

开发

本项目使用 TypeScript 编写，并使用模型上下文协议 SDK。修改代码：

在 src 目录中进行更改
运行 npm run build 进行编译
使用必需参数运行 npm start，以测试更改

许可证

MIT

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。