Clash Royale MCP Server

This is a Model Context Protocol (MCP) server for Clash Royale, providing tools and prompts for interacting with Clash Royale data.

Features

• Player Information: Get detailed information about players
• Clan Information: Get information about clans
• Tournament Data: Get current tournaments
• Card Information: Get information about cards in the game
• Deck Analysis: Prompt for analyzing Clash Royale decks
• Counter Strategies: Prompt for developing counter strategies against specific decks

Setup

1. Clone this repository
2. Install dependencies:

   npm install

3. Build the server:

   npm run build

4. Run the server:

   npm start

Configuration

Important: This MCP server requires a valid Clash Royale API key to function. The server makes real API calls to the Clash Royale API.

To set up your API key:

1. Register at the Clash Royale Developer Portal
2. Create a new API key
3. Set the CLASH_ROYALE_API_KEY environment variable with your API key in the claude_desktop_config.json file

API Key Configuration

When creating your API key on the Clash Royale Developer Portal, make sure to:

1. Set the correct IP addresses that will be allowed to use the API key
2. Enable the necessary endpoints (player, clan, etc.)
3. Copy the full API key (it should look like a long JWT token)

Using with Claude Desktop

To use this MCP server with Claude Desktop:

1. Make sure you have Claude Desktop installed
2. Install dependencies: npm install
3. Update the API key in claude_desktop_config.json
4. Run the setup script: ./setup-claude-config.sh
5. Start or restart Claude Desktop
6. Your Clash Royale MCP server will be available in Claude Desktop

The setup uses npx with ts-node to run the TypeScript code directly, without needing to build it first.

For detailed usage instructions, see USAGE.md.

Tools

The server provides the following tools:

Player Tools

• get-player: Get information about a player by tag

Clan Tools

• get-clan: Get information about a clan by tag
• search-clans: Search for clans based on various criteria
• get-clan-members: List members of a specific clan
• get-clan-warlog: Retrieve clan's war log
• get-clan-riverracelog: Retrieve clan's river race log
• get-clan-currentwar: Get information about clan's current war
• get-clan-currentriverrace: Get information about clan's current river race

Game Tools

• get-tournaments: Get current tournaments
• get-cards: Get information about cards in the game

Prompts

The server provides the following prompts:

Deck Prompts

• analyze-deck: Analyze a Clash Royale deck
• counter-strategy: Develop a counter strategy against a specific deck

Clan Prompts

• analyze-clan: Analyze a clan with focus on war, members, performance, or general aspects

Development

To modify or extend this server:

1. Edit the source code in the src directory
2. Rebuild the server:

   npm run build

3. Run the server:

   npm start

License

ISC