League of Legends Mock Match MCP

⚔️ AI-powered League of Legends mock match simulator and summoner comparison tool

This Model Context Protocol (MCP) server provides comprehensive League of Legends summoner analysis and mock match simulations based on historical performance data from the last 10 games.

Features

• 🔍 Summoner Analysis: Get detailed statistics including KDA, damage dealt, and win rates
• ⚔️ Mock Match Simulation: AI-powered 10-phase match progression simulation
• 🌍 Multi-language Support: Available in 7 languages
• 📊 Performance Comparison: Side-by-side summoner comparisons
• 🎯 Match Prediction: Outcome prediction based on historical data

Supported Languages

• English (EN/ENGLISH)
• Korean (한국어)
• Traditional Chinese (繁體中文)
• Japanese (日本語)
• Spanish (ESPAÑOL)
• Bengali (বাংলা)
• Punjabi (ਪੰਜਾਬੀ)

Installation

Prerequisites

• Python 3.10 or higher
• pip package manager

Setup

1. Clone the repository:

   git clone https://github.com/onepersonunicorn/lolgpt.git
   cd lolgpt
   

2. Install dependencies:

   pip install -r requirements.txt
   

3. Set up environment variables (optional):

   export LOL_API_URL="https://1tier.xyz"
   export LOL_DEFAULT_LANGUAGE="EN"
   export LOL_API_TIMEOUT="30"
   

4. Run the server:

   python main.py
   

Usage

Available Tools

The MCP server provides 6 different tools for various League of Legends simulation needs:

league_of_legends_summoner_vs_match

Main tool for comprehensive match simulation.

Parameters:

• uidA (required): Riot ID of first summoner
• tagA (required): Tag of first summoner
• uidB (required): Riot ID of second summoner
• tagB (required): Tag of second summoner
• lang (optional): Language for simulation (default: "EN")

Example API call

await league_of_legends_summoner_vs_match(
    uidA="Hide on bush",
    tagA="KR1", 
    uidB="Zeus",
    tagB="KR1",
    lang="EN"
)

Example Usage

Sample Output

🎮 **League of Legends Mock Match Simulation**
════════════════════════════════════════════

📊 Summoner A (PlayerOne#KR1) - Last 10 Games Statistics:
• Average Kills: 8.2
• Average Assists: 12.5
• Average Deaths: 4.1
• Average KDA: 5.05
• Average Damage Dealt: 28,450
• Win Rate: 70%

📊 Summoner B (PlayerTwo#NA1) - Last 10 Games Statistics:
• Average Kills: 6.8
• Average Assists: 9.2
• Average Deaths: 5.3
• Average KDA: 3.02
• Average Damage Dealt: 22,100
• Win Rate: 55%

🎯 Mock Match Simulation - Summoner's Rift:
════════════════════════════════════════════

Phase 1: Welcome to the Snowdown Showdown.
Phase 2: Thirty seconds until minions spawn.
Phase 3: Minions have spawned!
Phase 4: First blood! Zeus has been slain.
Phase 5: Hide on bush has slain an enemy!
Phase 6: Hide on bush has destroyed a turret.
Phase 7: Zeus Quadrakill!
Phase 8: Hide on bush is legendary!
Phase 9: Hide on bush has destroyed a inhibitor.
Phase 10: Hide on bush victory!

### Smithery Configuration

The server supports Smithery configuration via `smithery.yaml`:

startCommand:
  type: stdio
  configSchema:
    properties:
      debug:
        type: boolean
        default: false
      apiUrl:
        type: string
        default: "https://1tier.xyz"
      language:
        type: string
        default: "EN"
      timeout:
        type: number
        default: 30

API Integration

The server integrates with the 1tier.xyz API endpoint which provides:

• Summoner Statistics: Last 10 games performance data
• Match Simulation: AI-generated match progression
• Multi-language Support: Localized simulation text
• Real-time Data: Current summoner performance metrics

License

This project is licensed under the MIT License

Disclaimer

League of Legends mock match simulations are for entertainment purposes only. Results are based on historical performance data and do not guarantee actual match outcomes. League of Legends is a trademark of Riot Games, Inc.

Support

For issues and questions:

• Create an issue on GitHub
• Contact the development team

Acknowledgments

• Riot Games for League of Legends
• 1tier.xyz for providing the API infrastructure

Made with ❤️ for the League of Legends community