gw2cc MCP Demo

A reference implementation demonstrating MCP integration with gw2cc via JSON-RPC over WebSockets.

Architecture

Agent (Copilot/Claude) ─── stdio ───> MCP Server (.NET) ─── WebSocket ───> gw2cc (Server.gd)

The MCP server acts as a bridge between AI agents and gw2cc. It receives tool calls via stdio, translates them to JSON-RPC 2.0 requests, and sends them to a WebSocket server running inside gw2cc.

Requirements

• .NET 10 SDK
• gw2cc

Getting Started

1. Load the JSON-RPC server in gw2cc
   Add Server.gd to a plugin or autoload. It listens on ws://localhost:9080.

2. Configure MCP in your agent
   See MCP Configuration below.

3. Test
   Ask your agent to jump in game.

MCP Configuration

Using dotnet run

{
  "servers": {
    "CcMcp": {
      "type": "stdio",
      "command": "dotnet",
      "args": ["run", "--project", "path/to/CcMcp/CcMcp.csproj"]
    }
  }
}

Using compiled binary

{
  "servers": {
    "CcMcp": {
      "type": "stdio",
      "command": "path/to/CcMcp.exe"
    }
  }
}

Included Tools

| Tool | Description | |------|-------------| | jump | Makes the character jump | | query_skill_information | Queries skill data by ID |

Project Structure

| Path | Description | |------|-------------| | CcMcp/Tools/ | MCP tool definitions | | CcMcp/Services/ | JSON-RPC client and connection management | | Server.gd | JSON-RPC WebSocket server (runs in gw2cc) |