AI导哈

Valorant数据服务

一个社区驱动的Valorant数据协议服务器，提供实时游戏数据查询功能，包括账户信息、比赛历史和排行榜等。

  • by codeNilson
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 codeNilson/valorant-mcp-server

使用说明

🎯 Valorant MCP Server

Model Context Protocol Server for Valorant Data

A highly capable, community-driven Model Context Protocol (MCP) server that empowers your AI assistant to fetch real-time data from Valorant. Whether you're tracking performance, analyzing match history, or checking the competitive leaderboards, this MCP server seamlessly integrates Valorant statistics directly into your preferred AI clients.

📑 目录

✨ 特性

为您的AI配备全面的Valorant知识：

  • 👤 帐户查询：使用Riot ID或PUUID检索帐户详细信息、级别和玩家卡。
  • 🏆 排名和MMR：查看当前的竞争级别、排名（RR）和完整的比赛评级历史。
  • 🔫 比赛历史：访问最近游戏的详细摘要，可按地图、模式或平台进行筛选。
  • 📊 匹配详细信息深入了解赛后细节，包括经济、轮次和每位玩家的统计数据。
  • 🌐 排行榜：拉取任何地区的排名排行榜，筛选特定玩家，或查看历史赛季。

📸 演示/截图

（视觉效果即将呈现！）

🛠 技术栈

使用现代Python工具构建，以实现最大的性能和可靠性：

  • Python 3.13+
  • 紫外线 用于快速依赖管理
  • httpx 用于非阻塞API调用
  • mcp[cli] 用于无缝模型上下文Pr##🚀 快速启动/设置

要使用此服务器，您需要 Henrik API密钥 （一个在 HenrikDev文档)以及 码头工人 安装。

通过将以下代码段添加到配置文件中来配置您首选的MCP客户端。 您不需要克隆存储库来使用服务器；官方Docker镜像将自动使用。

🤖 克劳德桌面版

在哪里可以找到配置文件：

  • 窗户： %APPDATA%\Claude\claude_desktop_config.json
  • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  • Linux： ~/.config/Claude/claude_desktop_config.json

配置：

{
  "mcpServers": {
    "valorant-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HENRIK_API_KEY=your_api_key_here",
        "ghcr.io/codenilson/valorant-mcp-server:latest"
      ]
    }
  }
}

保存文件后完全重新启动Claude Desktop。

🌌 反重力

在哪里可以找到配置文件：

  • 直接内置到Antigravity UI中，通常在设置->MCP服务器中。

配置： 只需将此添加到MCP服务器配置菜单或JSON中：

{
  "mcpServers": {
    "valorant-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HENRIK_API_KEY=your_api_key_here",
        "ghcr.io/codenilson/valorant-mcp-server:latest"
      ]
    }
  }
}

💻 VS代码（房间代码/诊所）

在哪里可以找到配置文件：

  • 通常位于 ~/.vscode/mcp.json 或者在扩展的特定MCP设置UI内。（例如。， %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json 在Windows上）。

配置：

{
  "mcpServers": {
    "valorant-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HENRIK_API_KEY=your_api_key_here",
        "ghcr.io/codenilson/valorant-mcp-server:latest"
      ]
    }
  }
}

重新加载VS Code窗口(Ctrl+Shift+P -> Developer: Reload Window)保存后。

🛠 本地开发和高级设置

如果你想从源代码运行服务器，在本地构建Docker镜像，或者为项目做出贡献，请按照以下步骤操作。

先决条件

  • Python 3.13+ 和 紫外线 包管理器
  • Git

方案1：地方发展（通过紫外线）

  1. 克隆存储库：

    git clone https://github.com/codeNilson/valorant-mcp-server
cd valorant-mcp-server

  2. 同步依赖关系：

    uv sync

  3. 客户端配置： 配置您的MCP客户端以直接使用运行本地版本 uv:

    {
  "mcpServers": {
    "valorant-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\path\\to\\valorant-mcp-server",
        "run",
        "valorant-mcp-server"
      ],
      "env": {
        "HENRIK_API_KEY": "your_api_key_here"
      }
    }
  }
}

选项2：在本地构建Docker镜像

如果你更喜欢自己构建容器，而不是使用预构建的映像：

  1. 克隆和构建：

    git clone https://github.com/codeNilson/valorant-mcp-server
cd valorant-mcp-server
docker build -t valorant-mcp-server .

  2. 客户端配置： 使用与快速入门相同的配置，但替换 ghcr.io/... 带有本地标签的图像：

    {
  "mcpServers": {
    "valorant-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HENRIK_API_KEY=your_api_key_here",
        "valorant-mcp-server"
      ]
    }
  }
}

🙏 学分

这个项目之所以成为可能，得益于 API 提供非官方的Valorant API数据端点。

  • ⚡ API 文档: https://docs.henrikdev.xyz
  • ⚠️ 免责声明：这个项目是一个非官方的社区创建 不 隶属于、认可或赞助Riot Games或Valorant。Valorant和Riot Games是Riot Game，股份有限公司的商标或注册商标。

📜 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

相关 MCP