GW2 MCP Server

A Model Context Provider (MCP) server for Guild Wars 2 that bridges Large Language Models (LLMs) with Guild Wars 2 data sources.

Features

• Wiki Search: Search and retrieve content from the Guild Wars 2 wiki
• Wallet Information: Access user wallet and currency data via GW2 API
• Smart Caching: Efficient caching with appropriate TTL for static and dynamic data
• Rate Limiting: Respectful API usage with built-in rate limiting
• Extensible Architecture: Modular design for easy feature additions

Requirements

• Go 1.24 or higher
• Guild Wars 2 API key (for wallet functionality)

Installation

1. Clone the repository:

git clone https://github.com/AlyxPink/gw2-mcp.git
cd gw2-mcp

2. Install dependencies:

go mod tidy

3. Build the server:

go build -o gw2-mcp ./cmd/server

Usage

Running the Server

The MCP server communicates via stdio (standard input/output):

./gw2-mcp

You can configure Claude Desktop, LM Studio, or other LLM tools to interact with the server using this configuration:

{
  "mcpServers": {
    "gw2-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "alyxpink/gw2-mcp:v1"
      ]
    }
  }
}

MCP Tools

The server provides the following tools for LLM interaction:

1. Wiki Search (wiki_search)

Search the Guild Wars 2 wiki for information.

Parameters:

• query (required): Search query string
• limit (optional): Maximum number of results (default: 5)

Example:

{
  "tool": "wiki_search",
  "arguments": {
    "query": "Dragon Bash",
    "limit": 3
  }
}

2. Get Wallet (get_wallet)

Retrieve user’s wallet information including all currencies.

Parameters:

• api_key (required): Guild Wars 2 API key with account scope