kostadindev/League-of-Legends-MCP

League of Legends Model Context Protocol (MCP)

A Model Context Protocol (MCP) server for League of Legends exposing all Riot Games APIs, static resources (champions, items, tiers, etc.), and workflow prompts. Includes a MCP client with a chatbot UI to demonstrate it's utility made using a ReAct agent for tool/resource/prompt calls. You can build your own client or use Claude for Desktop.

MCP Server Features

• Riot Games API coverage: Account, Summoner, Match, League, Spectator, Champion, Clash, Tournament, Status, Challenges
• Static resources: champions, items, summoner spells, queues, maps, game modes, ranked tiers
• Workflow prompts: player stats, champion analysis, team comps, tournaments, improvement plans

MCP Client Features (Optional)

• ReAct Agent
• Chatbot UI
• Tool calling
• Resource Utilization
• Prompt Workflows

https://github.com/user-attachments/assets/101ee6dc-af42-4bf0-81b0-3caba49c83a7

Quickstart

Option 1: Using Docker 🐳 (Recommended)

Pull and run directly from Docker Hub:

# For stdio transport (Claude Desktop integration)
docker run -i -e RIOT_API_KEY=your_api_key_here kostadindev/league-mcp:latest

# For SSE transport (web integrations)
docker run -p 8000:8000 -e RIOT_API_KEY=your_api_key_here kostadindev/league-mcp:latest league-mcp --transport sse

Using Docker Compose:

version: '3.8'
services:
  league-mcp:
    image: kostadindev/league-mcp:latest
    environment:
      - RIOT_API_KEY=${RIOT_API_KEY}
    command: ["league-mcp", "--transport", "sse"]
    ports:
      - "8000:8000"
    restart: unless-stopped

Option 2: Install from PyPI

Simply install the MCP server using pip:

pip install league-mcp

Then run the server:

league-mcp

Option 3: Install from Source

1. Clone the repository:

   git clone https://github.com/kostadindev/League-of-Legends-MCP.git
   cd League-of-Legends-MCP
   

2. Install dependencies (choose one method):

   Option A: Using pip

   • In mcp-server/:

     cd mcp-server
     pip install -r requirements.txt
     cd ..
     

   • In mcp-client/:

     cd mcp-client
     pip install -r requirements.txt
     cd ..
     

   Note: With pip, you need to manually create and activate virtual environments. Remember to activate the appropriate environment before running the applications!

   Option B: Using uv (recommended for faster installs)

   • First install uv if you haven't already:

     pip install uv
     

   • In mcp-server/:

     cd mcp-server
     uv sync
     cd ..
     

   • In mcp-client/:

     cd mcp-client
     uv sync
     cd ..
     

   Note: uv automatically creates and manages .venv virtual environments in each directory. You don't need to manually create or activate them!

3. Set environment variables in .env files:

   • In mcp-server/.env:

     RIOT_API_KEY=your_riot_api_key // obtain for free from https://developer.riotgames.com/
     

   • In mcp-client/.env (only if you want to try out the client):

     GOOGLE_API_KEY=your_gemini_api_key // obtain for free from https://aistudio.google.com/ 
     

4. How to run the MCP server independently:

   Using pip/python:

   cd mcp-server
   python main.py
   

   Using uv:

   cd mcp-server
   uv run main.py
   

4.5. Run the MCP client and the MCP server together (from the project root):

Using pip/python:

python mcp-client/client.py mcp-server/main.py

Using uv:

uv run mcp-client/client.py mcp-server/main.py

• The client launches a Gradio web UI. Example queries:
  • What is the current rank of Sneaky#NA69?
  • Show me ddragon://champions

Project Structure

• mcp-server/ - MCP server (all Riot APIs, resources, prompts)
• mcp-client/ - LangChain ReAct agent client (Gradio UI)

Requirements

• Python 3.9+
• Riot API key (for server)
• Google API key (for client)

References

• Riot Games Developer Portal
• Model Context Protocol (MCP)

🤝 Contributing

We welcome contributions! Please see our for details on how to get started.

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

📄 License

This project is licensed under the MIT License - see the file for details.

⚠️ Disclaimer

This project is not endorsed by Riot Games and does not reflect the views or opinions of Riot Games or anyone officially involved in producing or managing Riot Games properties. Riot Games and all associated properties are trademarks or registered trademarks of Riot Games, Inc.

📚 Resources

• Riot Games API Documentation
• Model Context Protocol Specification

Made with ❤️ for the League community