Civilization VI MCP Server

An MCP (Model Context Protocol) server that provides Claude with real-time access to your Civilization VI game data. Get strategic analysis, diplomatic intelligence, military assessments, and more by connecting Claude to your active game.

Features

• Strategic Overview - Comprehensive situational briefing combining all intelligence
• Diplomatic Intelligence - Track relationships, alliances, and the reasons behind them
• Military Analysis - Monitor troop strength, combat desire, and threat levels
• Production Tracking - See what every civilization is building
• City Status - Analyze city growth potential and food challenges
• Victory Progress - Track who’s leading each victory type
• Score Breakdown - Understand where each civ’s score comes from (Empire, Tech, Wonders, etc.)
• Trend Analysis - Identify rising powers and declining civilizations
• Combat History - Review recent battles and ongoing conflicts
• World Congress - Track voting records and resolutions
• Great People - Monitor the great people race
• Cultural Victory Tracking - Track Great Artists, Writers, and Musicians

Requirements

• Node.js 18+
• Civilization VI (macOS or Windows)
• Claude Desktop

Important: You must enable game logging in Civilization VI for the MCP server to access game data. See Enable Game Logging below.

Installation

1. Clone the repository:

   git clone https://github.com/lowrykun/civ6mcp.git
   cd civ6mcp
   

2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

Enable Game Logging

The MCP server reads data from Civilization VI’s log files. You need to enable logging:

1. Find your UserOptions.txt file:

   • macOS: ~/Library/Application Support/Sid Meier's Civilization VI/UserOptions.txt
   • Windows: %LOCALAPPDATA%\Firaxis Games\Sid Meier's Civilization VI\UserOptions.txt

2. Add or modify this line:

   GameHistoryLogLevel=1
   

3. Start Civilization VI and play at least one turn to generate log data.

Claude Desktop Configuration

Add this to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "civ6": {
      "command": "node",
      "args": ["/path/to/civ6mcp/dist/index.js"]
    }
  }
}

Replace /path/to/civ6mcp with the actual path to where you cloned the repository.

Claude Project Setup (Recommended)

For the best experience, create a Claude Project with the strategic advisor instructions:

1. In Claude, create a new Project called “Civilization VI”
2. Copy the contents of PROJECT_INSTRUCTIONS.md into the Project Instructions
3. Start a conversation in that project